VAO PUSH / 使用指南
自建部署
先选择访问方式，再跟着向导完成安装。
01 · 准备一台 Linux 服务器
服务端面向 Linux amd64 / arm64，使用 systemd、Python 3 与 Docker Engine。选择一台你能管理的服务器，并确认设备可以访问所选 API 与 Web 端口。
02 · 选择怎样访问服务器
| 方式 | 你需要准备 | 适合什么情况 |
|---|---|---|
| IP + HTTP | 公网 IP、选定端口 | 无需域名；传输不加密，需自行评估网络 |
| 域名 + 自动 HTTPS | 域名解析、证书验证所需的 80 端口 | 由 Caddy 申请及续期证书；先检查现有端口占用 |
| 已有 HTTPS 反向代理 | 现有代理配置权限 | 服务绑定回环地址；Web 入口同时代理 /v1/ |
| 自带证书 | 有效证书与安全存放的私钥 | 你自行管理证书与续期 |
App 填写的是 API 地址，浏览器打开的是 Web 地址。使用不同端口时，两个地址可能不同；配置统一 HTTPS 反代后，也可以使用同一个域名入口。
03 · 运行安装向导
正式包公开后，下载匹配 CPU 架构的预构建包，解压并进入目录运行：
shell
sudo bash install.sh| 向导选项 | 默认值 |
|---|---|
| 界面语言 | 中文，可切换 English |
| API 端口 | 8188 |
| Web 端口 | 18188 |
| 初始管理密码 | 随机生成 24 位；安装后妥善保存 |
| 访问方式 | IP + HTTP |
安装结束会显示 App 地址、Web 地址和初始管理信息。升级保留现有密码和数据。安装程序不会关闭防火墙，需要在服务器及提供商安全组中放行实际使用的端口。
04 · 连接 App，打开 Web
- 在 App 添加服务器地址和设备名称，创建连接。
- 打开 Web 地址，用安装时的管理信息登录。手机连接不需要填写 Web 管理密码。
- 选择消息接收设备，手动发送消息；或创建数据源和卡片。
普通用户不需要在 Web 填写 Apple 推送私钥。正式安装程序负责写入与官方客户端匹配的推送身份；这部分仍在发布准备中。
运维与公开文档
部署者负责系统更新、访问控制、业务凭据和备份。备份可能包含密钥，应保存在独立加密存储中。升级前先备份，程序回退不等于数据库迁移回退。
源码与安装说明可在 GitHub 查阅。正式安装包仍在准备，当前请以本页的可用状态说明为准。
阅读完整安装文档