管理员

准备服务器

• Linux x86_64，Docker 24 以上和 Docker Compose v2；2 核 2 GB 起，建议 4 GB 内存。
• 磁盘：镜像约 4 GB，另加对话和附件。
• 两个域名解析到这台服务器：面板（如 atrace.example.com）和登录（默认 auth.atrace.example.com）。80、443 端口对外开放时自动申请证书；已有 Nginx 负责 HTTPS 的，可以让它转发过来。

安装

ATRACE_DOMAIN=atrace.example.com ADMIN_EMAIL=admin@example.com ATRACE_ORG_NAME=示例公司 ./install.sh

缺的设置会在终端里问。装完会打印面板地址、管理员账号和一次性密码，以及插件和 atrace-agent 的安装命令。密钥全部自动生成，保存在服务器的数据目录里。要用飞书登录，安装时加上飞书应用的 FEISHU_APP_ID 和 FEISHU_APP_SECRET。

让员工接入

浏览器插件

安装包的 deploy/extension 目录里有统一安装的脚本：

• Windows：电脑加入了域，或员工用 Edge 时，可以强制安装，员工不能停用。
• Mac：有 MDM 时，下发描述文件强制安装。
• Linux：写入浏览器策略即可强制安装。
• 不满足上面条件的电脑：员工按员工安装自己装。停用或卸载会在面板「采集状态」页显示出来。

atrace-agent

面板里有带好公司地址的安装命令，发给用编程工具的员工即可。员工安装时要在面板上批准一次，批准人就是这台电脑的主人。

邀请员工

在面板「邀请」里给员工发邀请链接或邮件，员工登录后就加入公司。

权限和审计

• 员工默认只能看自己的对话。管理员按角色开放查看范围，可以限定到某个项目，也可以把单条对话授权给某个人。
• 新装的公司租户默认不允许员工删除对话、关闭某个平台的采集，可以在面板里改。
• 查看他人对话、导出、通过 MCP 或接口读取，都记在审计日志里；员工能看到谁看过自己的对话。
• 要接入公司自己的系统，在「服务账号」里点「新建只读密钥」，选全公司或某个项目，并设有效期。

离职交接

员工离职后，他的对话保留在服务器上。在面板里把它们转给接手的人，或整体导出。

升级和退回

./upgrade.sh             # 升级到安装包里的版本
./rollback.sh            # 升级出了问题，退回原来的版本，数据不动

升级前会先打印这次跨过的各版本说明，再检查设置和磁盘、备份两个数据库，最后检查服务是否正常。升级失败时终端会给出退回的命令。

备份

sudo ./backup-enable.sh  # 每天备份，每周做一次恢复演练

建议再配一个服务器以外的备份位置。备份状态显示在面板「租户设置」里。

出了问题

在面板「租户设置」→「诊断包」点「导出」，把下载的 ZIP 发给我们。里面有版本、自检结果、备份状态、各电脑的采集状态和最近的错误日志，不含对话内容，也不含员工的姓名、邮箱、电脑名和 IP。

也可以在服务器上运行自检，逐项检查数据库、登录、文件存储、发信和备份：

docker compose -p atrace --env-file /opt/atrace/.env -f docker-compose.yml -f /opt/atrace/compose.site.yml \
  exec -T atrace /atrace-server selfcheck