主题
安全加固
deploy 服务端拥有「以服务端账号执行任意 Shell」的能力——它的暴露面等同于一个远程执行入口。 本页按暴露面、凭据、权限、数据四层给出加固清单。
网络暴露面
- 绑定回环:
-listen 127.0.0.1:10055(systemd unit 默认 0.0.0.0,需 sed 改回),经反代或 SSH 隧道访问。 - HTTPS 反代:Nginx/OpenResty 转发 WebSocket 升级头、
proxy_buffering off、proxy_read_timeout足够长;证书就绪后再开放公网。 - 不直接暴露 10055:安全组/防火墙只放 80/443(及业务端口)。
- Hook 端点免登录:
/api/v1/hooks以令牌为全部凭据,必须 HTTPS;URL 形式令牌注意访问日志脱敏。 - 内网穿透场景(frp 等):穿透隧道本身也要鉴权与最小端口映射,只映射必需端口。
凭据与密钥
| 对象 | 要求 |
|---|---|
| 登录 JWT | 默认 168h 过期;仅人工会话使用 |
API Token dk_ | 自动化专用;一人/一系统一令牌,泄露即撤销;CLI 配置 0600 |
Hook Token hk_ | 只存哈希、明文仅一次;最小分发;创建时设有效期(expiresInDays);仅重置/删除;限流 60/min 默认 |
| Git 凭据 | 加密存储;用部署密钥/只读 token,不用个人账号密码;带口令 SSH key 不支持 |
data/secret.key | 与数据库一起备份;丢失无法恢复 Secret 与凭据;权限 0600 |
data/jwt.key | 同上备份;泄露可伪造会话 |
- 密码/密钥不进 Git、不进项目脚本明文、不进聊天与工单;用 Secret 变量或服务端受限文件。
- 中间件生成的随机密码会在安装日志出现一次:改自管密码、限制日志权限。
- CLI 侧
~/.deploy/config.yaml按服务器凭据保护;server list/whoami输出已打码,仅config get token明文。
权限与可见性
- 角色:admin 管用户/凭据/中间件/系统设置;user 管自己的项目/任务。
- 编辑与执行仅 owner 或 admin;visibility
allReadable只给他人只读,ownerOnly完全不可见——多租户/跨团队选后者。 - 开放注册为预留项(当前无自助注册接口、设置页只读):账号一律 admin 创建;建用户/重置密码会置首次改密标记。
- 登录失败锁定:同名 5 次失败锁 10 分钟(内存态,重启清零)——不要依赖它做长期防爆破,反代层限速更可靠。
- 服务端执行账号即脚本权限:仓库 unit 以 root 运行便于 systemctl;若改普通账号,注意
NoNewPrivileges=true会阻止 sudo 提权。
中间件与工具链默认值
- 数据库/Redis 默认端口映射宿主机、面向内网便利;公网前改绑定/防火墙/强密码。
- Elasticsearch 默认关闭安全认证:公网必须开认证或限制来源 IP。
- 容器数据卷随 remove 保留:删卷是独立破坏性操作,需显式授权。
- 工具链安装脚本以 root 写系统目录:仅 admin 可触发,参数 URL 指向可信镜像源。
日志与审计
- 日志含命令输出与 Secret 掩码;dataDir 建议 0750,反代不泄露日志路径。
- 保留期
logRetentionDays与单运行上限logMaxBytes按合规要求调整。 - 发布审计用
runs list(触发者/时间/终态)+ 日志内GIT_COMMIT;失败运行不要删项目清痕迹。
备份与恢复
停服 → 打包整个 dataDir(含 deploy.db、secret.key、jwt.key、logs)→ 替换二进制 → 启动。 工作区如需保留单独备份。恢复时 secret.key 必须与数据库同批,否则 Secret 解密失败。 详见 升级、备份与恢复。
延伸阅读
- 用户、角色与可见性、凭据与 API Token。
- HTTP Hook 触发 的安全清单。
- 故障排查:鉴权失败、限流等现象索引。