下载企业网关
网关装在企业内网的一台电脑或服务器上，员工的 AI 请求都经过它。下面这条命令会下载、校验、安装并启动网关；再运行一次就是升级。
一条命令安装
正在读取版本信息……
默认装到 ~/officoa-gateway，管理后台在 http://127.0.0.1:8787。同时开启开机自启（推荐）：
要换目录或端口：
服务器配置要求
网关部署在企业自己的服务器上（物理机、虚拟机或云主机都可以），员工的 AI 请求、对话原文和调用记录都只存在这台服务器上。
安装前准备
- 一台满足上面要求的服务器，能一直开着；员工电脑能通过内网访问它
- 已装
curl和uv（Python 运行环境管理工具）。macOS 装 uv：brew install uv；Linux：curl -LsSf https://astral.sh/uv/install.sh | sh，详见 uv 安装说明 - 安装时能访问本网站和 Python 软件源（首次需要几分钟）
- 端口 8787 未被占用
- 购买后拿到的激活码
安装之后
- 激活打开管理后台，输入激活码，创建企业管理员账号。模型由平台提供，激活后即可使用，不需要准备模型服务商的账号或密钥。
- 让员工电脑能连上只在本机试用可以跳过。给内网其他电脑用时，把
OFFICOA_HOST改成0.0.0.0，OFFICOA_GATEWAY_PUBLIC_URL改成员工电脑能访问的地址。 - 邀请员工在管理后台“员工”页面新建员工，把邀请链接发给他们。
常用命令
在安装目录下运行（默认 ~/officoa-gateway）：
bin/officoa-gateway start | 启动网关（后台运行） |
bin/officoa-gateway stop | 停止网关 |
bin/officoa-gateway restart | 重启，修改 gateway.env 后需要 |
bin/officoa-gateway status | 查看是否在运行 |
bin/officoa-gateway logs | 查看日志（Ctrl+C 退出） |
bin/officoa-gateway enable-autostart | 开启开机自启，见下方说明 |
bin/officoa-gateway disable-autostart | 关闭开机自启（同时停止网关） |
开机自启
网关停了，员工就用不了 AI。建议安装时加 OFFICOA_AUTOSTART=1，或装好后运行 bin/officoa-gateway enable-autostart。开启后网关意外退出会自动重启，升级时也会自动重新启动。
| 系统 | 方式 | 什么时候启动 |
|---|---|---|
| macOS | launchd（~/Library/LaunchAgents 下的用户服务） | 安装网关的这个用户登录 Mac 之后。用作常开服务器时，请在“系统设置 → 用户与群组”里打开该用户的自动登录 |
| Linux | systemd 用户服务（systemctl --user） | 该用户登录之后。要开机即启动、不用登录，请管理员运行一次 sudo loginctl enable-linger <用户名> |
- 开启自启后照常用
start、stop、restart、status，它们会交给 launchd / systemd 执行。stop之后网关保持停止，直到下次start或下次开机登录。 - macOS 上不要把网关装在“文稿”“桌面”“下载”文件夹里，系统会阻止后台服务读取这些位置。默认的
~/officoa-gateway没有这个问题。 - Linux 上安装目录不能含空格。
配置项
都在 gateway.env 里，改完运行 bin/officoa-gateway restart。
| 配置 | 说明 |
|---|---|
OFFICOA_PLATFORM_URL | 平台地址，安装时自动填好 |
OFFICOA_HOST | 监听地址。只在本机用填 127.0.0.1，给内网用填 0.0.0.0 |
OFFICOA_PORT | 端口，默认 8787 |
OFFICOA_GATEWAY_PUBLIC_URL | 员工电脑访问网关的地址，写进员工的 OpenCode 配置和邀请链接 |
OFFICOA_UPSTREAM_URL | 一般不填（模型由平台提供）。只有接企业自有模型服务（OpenAI 兼容接口）时才填写，此时不使用平台的模型额度 |
OFFICOA_UPSTREAM_KEY_FILE | 与上一项配合使用：企业自有模型服务的密钥文件路径（权限 600） |
升级与数据
再运行一次安装命令即可升级。安装脚本会先停止网关，替换程序文件，保留 data/（数据库、对话档案、网关凭证）和 gateway.env，然后重新启动。
请定期备份安装目录下的 data/。它保存着员工的全部调用记录和原文，只存在企业自己的电脑上，平台没有副本。
手动安装
不方便直接运行网络脚本时，先下载安装包和校验文件，核对后再安装：
正在读取……