一台服务器
推荐使用 Linux 云服务器，也可以先在 Windows 本机运行。确保开放服务端口，并能长期保持在线。
Before Deploy
部署前，先准备好这些东西。
模型接口
准备 OpenAI 兼容接口的 API Key，或提前启动 vLLM 本地推理服务，并确认模型可以正常响应。
Redis 服务
雨时需要 Redis 保存会话状态和缓冲消息。部署前请先启动 Redis，并记录主机和端口。
Config
核心配置都写在 `.env` 里。
LLM
模型配置
填写 `LLM_BACKEND`、`LLM_API_KEY`、`LLM_BASE_URL` 和 `LLM_MODEL`，决定雨时使用哪个模型。
Port
服务端口
默认监听 `127.0.0.1:8080`。上线域名时，把反向代理指向这个端口即可。
Chat
聊天接入
如果接入 QQ，配置 NapCatQQ 的反向 WebSocket 地址，并设置允许对话的白名单用户。
Check
启动后，按这个顺序检查。
1
访问 `/health`，确认后端服务在线。
2
访问 `/api/status`，确认 Redis、模型配置和运行状态正常。
3
接入聊天端后，先用白名单账号发送一条测试消息，再观察日志是否收到事件。
Deploy
照着这几步，把雨时部署起来。
准备服务器和依赖
准备一台云服务器或本地机器，安装 Python 3.10+、Redis、Git，并确认能访问你的大模型 API。
下载项目
把项目代码上传到服务器，进入项目目录后安装 Python 依赖。
pip install -r requirements.txt
配置环境变量
复制 `.env.example` 为 `.env`，填写模型接口、Redis 地址、端口、主动问候时间和目标用户。
cp .env.example .env
启动雨时
Windows 使用 PowerShell 脚本，Linux 或服务器环境使用 Shell 脚本。
.\start.ps1
./start.sh
上线域名
把你的域名解析到服务器 IP，使用 Nginx 或宝塔反向代理到雨时服务端口。默认服务地址通常是 `127.0.0.1:8080`。
接入聊天端
如果你要接入 QQ，需要先配置 NapCatQQ，再把反向 WebSocket 地址指向雨时后端。完成后可以用白名单控制允许聊天的用户。
Start
准备好了，就让雨时开始来信。
部署完成后，先访问健康检查接口确认服务在线，再配置域名、HTTPS 和聊天端接入。