Files
AndroidDeviceStreaming/docs/deployment-ttstd.md
T

101 lines
5.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# ttstd.com 实际部署
## 服务器与连接地址
- 服务器:`175.178.213.60`,Debian 12 amd64。
- 中继基地址:`wss://ttstd.com/ads`,已设为两端程序的默认值。
- 健康检查:`https://ttstd.com/ads/healthz`。
- 源站直连配置:`--connect-address 175.178.213.60:443`,或环境变量 `ADS_CONNECT_ADDRESS`。
`ttstd.com` 当前通过 Cloudflare 解析。部署测试中,当前电脑直连 Cloudflare 的 TLS 连接超时,而直连服务器正常。因此启动脚本默认指定源站地址:TCP 连接公网 IP,HTTP Host / TLS SNI 仍为 `ttstd.com`,证书链与主机名校验保持开启,不修改系统 hosts,也不关闭证书校验。
根域名已有解析和证书,当前方案**不需要添加或修改 DNS 记录**,主站内容仍由原配置处理。Nginx 仅新增 `/ads/` 路径,中继路径不缓存、不记录含票据的访问 URL。
## 服务器安装位置
| 项目 | 位置 |
|---|---|
| 程序 | `/opt/ads/ads-server` |
| 角色令牌 | `/etc/ads/server.env`,root 专用,0600 |
| systemd | `/etc/systemd/system/ads-server.service` |
| 内部监听 | `127.0.0.1:18081`,不开放公网 |
| Nginx 路径配置 | `/etc/nginx/snippets/ads-path.conf` |
| 主站配置 | 在现有 `zz-ttstd-main.conf` 的 `ttstd.com:443` 块中加入 include |
| 配置备份 | `/var/backups/ads/<UTC 时间>/` |
中继使用独立的 `ads` 系统用户,已设置开机启动、故障重启、`GOMEMLIMIT=128MiB` 和 systemd `MemoryMax=256M`。部署后 systemd 报告空闲服务内存约 2.8 MiB;这是当时的服务 cgroup 计量,不是负载峰值或完整机器内存。
管理命令:
```sh
systemctl status ads-server --no-pager
journalctl -u ads-server -n 50 --no-pager
systemctl restart ads-server
curl --noproxy '*' --resolve ttstd.com:443:127.0.0.1 https://ttstd.com/ads/healthz
```
TLS 沿用现有主站证书,核验到的有效期截止 `2026-11-28 06:59:59 UTC`。需要按现有主站证书管理方式及时续期;本次未接管或修改其续期流程。
## 远程 Windows 电脑
已部署到 `192.168.5.222`,目录为 `C:\Users\TT\AppData\Local\AndroidDeviceStreaming\agent`。`ADS-Agent` 计划任务已运行,使用账号 `TT` 的后台密码登录,设置开机和登录触发、故障重启。详细管理方式见 `deploy/windows/README.md`。以下项目目录脚本方式仍可用于手动运行其他网关,勿对同一设备 ID 重复启动。
复制以下文件并保持目录结构,角色配置不要公开或提交 Git:
```text
<部署目录>/
bin/ads-agent.exe
scripts/start-agent.ps1
config/private/agent.env
```
在该部署目录执行:
```powershell
.\scripts\start-agent.ps1
```
脚本默认接入手机 `192.168.100.141:5555`,注册 ID 为 `home-phone`。该地址必须从远程电脑可达。也可覆盖 `-Target` 和 `-Device`。此直接 TCP 模式不需要对公网暴露远程 ADB Server。
## 本地 Windows 电脑
桌面客户端已同步当前公网配置,可运行 `scripts/start-desktop.ps1`,或打开 `bin/desktop-win-x64/Ads.Desktop.exe`。它会读取项目的客户端凭据,显示远程 `home-phone` 并管理本地连接、重连、断开、设备信息和独立手机控制窗口。桌面模式已管理 ads-client 子进程,使用时无需再单独启动下面的命令行客户端。
本地配置位于 `config/private/client.env`,已配置目录 ACL 并被 Git 忽略。该文件只包含客户端角色凭据和非敏感连接地址,不包含服务器 root 密码。
```powershell
.\scripts\start-client.ps1
# adb 不在 PATH 时:
.\scripts\start-client.ps1 -Adb 'F:\AndroidSDK\platform-tools\adb.exe'
```
默认端口 `127.0.0.1:15555`。另开终端:
```powershell
adb devices -l
adb -s 127.0.0.1:15555 shell
scrcpy -s 127.0.0.1:15555
```
启动脚本读取角色令牌,不把令牌放到程序命令行。直接运行二进制时,需自行加载对应环境变量;`--server` 可省略,但若当前 DNS 链路仍不可达,需设置 `ADS_CONNECT_ADDRESS` 或显式传入源站地址。
## 域名如果以后改为独立子域名
当前根域名路径已经可用。若改成 `ads.ttstd.com`,需要额外完成以下三步,不能只添加 DNS 就直接使用:
1. DNS 添加 A 记录:主机名 `ads`,值 `175.178.213.60`,先用“仅 DNS”(关闭 Cloudflare 橙云),TTL 自动或 300 秒。不要修改现有根域名或其他子域名记录。
2. 服务器新增该域名的 Nginx 虚拟主机,取得覆盖 `ads.ttstd.com` 的公有 TLS 证书,并配置 WebSocket 反向代理。现有主站证书不覆盖此子域名。
3. 两端改用 `--server wss://ads.ttstd.com`。DNS 直连稳定后可去掉 `--connect-address` / `ADS_CONNECT_ADDRESS`。
## 本次验证
已使用正式 Rust 二进制经公网 Linux 中继完成真实手机测试:普通本地 `adb devices` 显示为 `device`,读取型号 `AOSP on crosshatch`,Shell 回显正确。最新测试只启动本地客户端,连接远程 Windows 后台任务注册的 `home-phone`;远程守护程序直接接入手机 TCP 5555。没有在本地启动网关,也没有通过远程 ADB Server 5037 中转。
远程任务重启后重复测试也通过。测试的 ADB 数据链路只使用公网中继;部署管理仍通过提供的 VPN 地址 SSH 进行,没有关闭系统 VPN,以免影响其他工作。开机启动触发器已配置和检查,未重启远程电脑。测试临时本地连接已清理,远程网关保留后台运行。
可复现命令(角色令牌只从私有文件读取):
```powershell
python tests/real_device.py --relay-url wss://ttstd.com/ads --connect-address 175.178.213.60:443 --credentials-dir config/private --existing-device home-phone
```