现场使用
安装部署手册
给这台电脑上的使用人员或现场管理员。从租户中心审批通过后下载 ZIP。账号、密码、域名已写在包内 tenant.json，一般不必再手填。排障搞不定时联系友速，不要自行改配置文件。
租户中心：国内 frp.myu8.cn/tenant/ · 海外 frp.u8ai.cn/tenant/。下载时请选对系统：Windows / macOS / Linux。三个包不能混用。
1. 装上之后能做什么
这台电脑没有独立公网 IP 时，也可以用你们的网站域名从外网打开页面。业务文件仍在这台电脑上。
你只需要：解压后按下面步骤装一次、保持开机、把网页文件放进约定文件夹。不要改网卡、路由，也不要给这台电脑「对外开放 80/443 端口」。
2. 安装前准备
- 已从租户中心下载对应系统的 ZIP，并解压到本机任意位置（例如 Windows 的
D:\ep\）。 - 电脑能上网。ZIP 不含 frpc 等大文件，安装时会从当前接入区服务器自动下载。
- 安装目录所在磁盘可写。Windows 默认
D:\USU；macOS / Linux 默认用户目录下的USU。 - Windows 需要能「以管理员身份运行」的账号。
- 云电脑：保持官方客户端在线；长时间断开后可能关机，网站也会中断。不要改网卡、路由，不要装 VPN，不要动厂商桌面软件。
远程传文件不是默认开通的。若友速要求开通，他们会另给端口号；不要自己选端口。
3. 先给杀毒软件放行（Windows）
安装程序里的联网工具常被 Windows Defender 或云枢误报（提示类似 Trojan:Win32/Kepavll!rfn）。这是误杀，不是安装包带了木马。
一键安装会自动给本机 Defender 加排除项。若本机还有云枢，必须在云枢控制台把下面路径加入白名单（云枢没有自动命令）：
- 安装目录（例如
D:\USU\） - 安装包解压后的文件夹（例如
D:\ep\） C:\Windows\Temp- 若是云电脑，常见还有
D:\Temp、D:\Temp\FileTemp
若已经报毒：在隔离区恢复被删的程序 → 加白名单 → 再重装一次。典型现象：解压提示含病毒；安装后接入相关服务显示已启动又马上停止；某个 .exe 装完就消失。
4. 一键安装
Windows
解压后双击 install.cmd。会请求管理员权限，并自动读取 tenant.json。
也可以在管理员 PowerShell 里运行：
powershell.exe -ExecutionPolicy Bypass -File D:\ep\install.ps1
默认装到 D:\USU。改目录：
powershell.exe -ExecutionPolicy Bypass -File D:\ep\install.ps1 -UsuRoot D:\你们的目录
友速要求开通远程传文件时，再加他们给的端口，例如 -SshRemotePort 10022。测试页「主机」文案可加 -HostLabel "名称"。
macOS / Linux
请使用租户中心下载的 macOS 或 Linux 包。解压后在终端执行：
chmod +x install.sh uninstall.sh ./install.sh
默认装到 $HOME/USU。改目录：USU_ROOT=/opt/usu ./install.sh。需要本机已有 python3。
开通远程传文件：SSH_REMOTE_PORT=端口 ./install.sh。测试页文案：HOST_LABEL='名称' ./install.sh。
装完后的目录
Windows：
安装目录\ ├── www\ 网站文件（日常改网页主要动这里） ├── Edge\ 接入服务（不要随意删除） └── Nginx\ 网站服务（不要随意删除）
macOS / Linux：
安装目录/ ├── www/ 网站文件（日常改网页主要动这里） └── Edge/ 接入服务（不要随意删除）
若开通了远程传文件，Windows 还会多出 OpenSSH 相关目录。日常改网站仍然只动 www。
5. 怎么确认装好了
- 用浏览器打开友速给你的网站域名（建议用手机或另一台电脑的流量，避免只在本机自测）。
- Windows：本机「服务」里
usuteck.frpc和usuteck.nginx应为正在运行。若开通了远程传文件，还会有sshd。 - macOS / Linux：电脑重启后接入会自动起来；本机可先访问
http://127.0.0.1:3000/health.txt。 - 网页文件在
安装目录/www/。以后更新页面：把文件拷进这个文件夹即可（或由友速远程传入）。
网站要长期可访问：这台电脑必须开着。关机、休眠、云电脑被回收后，外网就打不开。
6. 日常使用
| 你想做的 | 怎么做 |
|---|---|
| 更新网页 | 覆盖 安装目录/www/ 里的文件 |
| 看测试页主机名称 | 安装时的主机名称参数，或直接改 www/index.html 里的字 |
| 电脑重启 | 服务会自动起来，一般不用重装 |
| 网站突然打不开 | 先看是不是关机/断网；Windows 再看杀毒是否又隔离了程序。搞不定联系友速，不要改网络设置 |
换域名、改账号、重装到另一台电脑：把情况告诉友速，按他们指示卸载后重装，或用新的 ZIP 再跑一遍第 4 节。不要自己改配置文件。
7. 不要做的
- 不要改网卡、默认路由，不要开「入站 80/443」
- 不要装 VPN / 组网软件来「代替」本次安装
- 不要用远程桌面当外网入口；云电脑进桌面仍用官方客户端
- 不要把账号、密码、安装包发到公网或无关群聊
- 不要删除
Edge、Nginx文件夹，也不要结束你不认识的厂商桌面进程
8. 卸载（仅当友速要求）
Windows：解压后双击 uninstall.cmd（会请求管理员权限）。默认卸 D:\USU。若当时装到了别的目录：
uninstall.cmd D:\你们的目录
也可以在管理员 PowerShell 里运行：
powershell.exe -ExecutionPolicy Bypass -File D:\ep\uninstall.ps1 powershell.exe -ExecutionPolicy Bypass -File D:\ep\uninstall.ps1 -UsuRoot D:\你们的目录
会清掉接入服务、网站服务和安装目录下的 Edge、Nginx、www 等。不会删除安装目录这一层空文件夹本身。若要先看会删什么，可加 -WhatIf。若友速要求保留远程传文件组件，加 -KeepOpenSSH。
macOS / Linux：
USU_ROOT=$HOME/USU ./uninstall.sh
会停止开机自启，并删除安装目录下的 Edge 与 www。
安装参数、域名和账号以租户中心下载包内的 tenant.json 以及友速当场说明为准。