diff --git a/docs/11-server-test-deployment.md b/docs/11-server-test-deployment.md index 03c4dc8..f21d528 100644 --- a/docs/11-server-test-deployment.md +++ b/docs/11-server-test-deployment.md @@ -41,37 +41,75 @@ ### 团队 SSH 访问(22 端口) -阿里云控制台配置:`轻量应用服务器 → 防火墙 → 添加规则`,填写协议 TCP、端口 22、来源 `0.0.0.0/0`,备注“团队 SSH 远程维护”。这只允许网络连接,不能替代 SSH 身份认证。阿里云文档将 22 定义为 Linux SSH 端口,并建议按需限制来源 IP。[阿里云防火墙说明](https://help.aliyun.com/zh/simple-application-server/user-guide/manage-the-firewall-of-a-server) +完成下述密钥登录与 sudo 验证后,再配置阿里云控制台:`轻量应用服务器 → 防火墙 → 添加规则`,填写协议 TCP、端口 22、来源 `0.0.0.0/0`,备注“团队 SSH 远程维护”。已有相同规则无需重复添加。初始化期间可以使用控制台远程连接,或暂时只允许维护人员当前公网 IP。这只允许网络连接,不能替代 SSH 身份认证。[阿里云防火墙说明](https://help.aliyun.com/zh/simple-application-server/user-guide/manage-the-firewall-of-a-server) -服务器上逐位成员创建账号和公钥。以下示例中的账号和公钥替换为真实值,不要把私钥上传到服务器: +每位成员先在自己的电脑执行 `ssh-keygen -t ed25519`,设置私钥口令;已有密钥时不要覆盖。只把 `.pub` 文件内容交给管理员,私钥留在个人电脑。 + +服务器上逐位成员创建账号和公钥。以下示例仅针对新账号,账号名替换为真实值;若账号已存在,先检查其权限,不要覆盖已有公钥文件: ```bash # 使用当前已验证的管理员会话执行;先不要关闭当前窗口 -sudo adduser --disabled-password --gecos "" moyi-dev1 -sudo usermod -aG sudo moyi-dev1 # 只有需要服务器管理权限的开发者才加入 sudo +sudo adduser moyi-dev1 sudo install -d -m 700 -o moyi-dev1 -g moyi-dev1 /home/moyi-dev1/.ssh -sudo tee /home/moyi-dev1/.ssh/authorized_keys >/dev/null <<'EOF' -ssh-ed25519 AAAA... dev1@company -EOF +sudo nano /home/moyi-dev1/.ssh/authorized_keys +``` + +在文件中粘贴该成员完整的公钥,单个公钥占一行,保存退出,再执行: + +```bash sudo chown moyi-dev1:moyi-dev1 /home/moyi-dev1/.ssh/authorized_keys sudo chmod 600 /home/moyi-dev1/.ssh/authorized_keys ``` -每位成员在自己的电脑执行 `ssh-keygen -t ed25519`,只把 `.pub` 文件内容交给管理员。先分别开新窗口验证 `ssh moyi-dev1@39.96.90.106` 成功,再执行 SSH 加固: +`adduser` 设置的是本机账号密码,后续禁用 SSH 密码登录不影响 sudo 使用该密码验证。不要创建没有可用密码的账号后,仅加入 sudo 组就假定可以管理服务器。 -```bash -sudo install -d -m 755 /etc/ssh/sshd_config.d -sudo tee /etc/ssh/sshd_config.d/90-moyi-team.conf >/dev/null <<'EOF' +仅对负责部署和运维的成员执行 `sudo usermod -aG sudo moyi-dev1`。sudo 和 Docker 组都可能赋予接近 root 的能力,不要默认授予所有开发者。 + +成员开新窗口,用 `ssh -o PreferredAuthentications=publickey moyi-dev1@39.96.90.106` 验证密钥登录,运维成员还需在新会话执行 `sudo -k` 和 `sudo whoami`,输入自己的本机账号密码后应显示 `root`。首次连接核对主机指纹与控制台获得的指纹一致。至少一个非 root 管理员完成以上验证,再执行 SSH 加固。 + +保留当前管理员会话和控制台救援入口。检查并备份原 SSH 配置后,用 `sudoedit /etc/ssh/sshd_config.d/00-moyi-team.conf` 添加以下配置;文件已存在时先读取并合并,不覆盖其他用途的配置: + +```text PermitRootLogin no PasswordAuthentication no KbdInteractiveAuthentication no PubkeyAuthentication yes -EOF -sudo sshd -t -sudo systemctl reload ssh +AuthenticationMethods publickey ``` -保留阿里云 Workbench/VNC 救援入口和至少一个已验证的 sudo 会话。成员离职或不再参与时,删除其账号或公钥,不要旋转其他成员的密钥。22 对公网开放会收到扫描,建议安装并启用系统安全更新和 `fail2ban`;上线前再迁移到 VPN/堡垒机白名单。 +OpenSSH 通常取最先读到的配置,不能假设较大数字文件名会覆盖云镜像设置。运行 `sudo /usr/sbin/sshd -t` 检查语法,再用 `sudo /usr/sbin/sshd -T` 核对上述五项实际值;有 Match 条件时,还需使用 `-T -C user=成员账号,host=客户端主机名,addr=客户端公网IP,laddr=服务器地址,lport=22` 按真实连接分别核对。不是期望值时停止,排查 Include 顺序和 Match 条件,不要直接重载。[Ubuntu SSH 配置说明](https://ubuntu.com/server/docs/how-to/security/openssh-server/) + +全部检查通过后执行 `sudo systemctl reload ssh`,再开新窗口验证密钥登录及 sudo,成功后才关闭旧会话、放宽防火墙来源。保留阿里云控制台救援入口。成员退出项目时撤销其公钥和账号访问,必要时结束已有会话;不要影响其他成员。22 对公网开放会收到扫描,需维护系统安全更新、查看登录日志,可补充 `fail2ban`;长期再迁移到 VPN/堡垒机白名单。 + +### 当前部署节点:先检查,再安装 + +以下命令在目标 MOYI 服务器的远程终端执行,不是在 Windows PowerShell 执行。只读取状态,不安装软件、不调整 SSH、不修改路由: + +```bash +whoami +cat /etc/os-release +ip -br -4 addr +ip -4 route +free -h +df -h / +sudo ss -lntp +sudo ufw status +sudo /usr/sbin/sshd -T | grep -E '^(port|permitrootlogin|passwordauthentication|kbdinteractiveauthentication|pubkeyauthentication|authenticationmethods) ' +if command -v docker >/dev/null 2>&1; then + sudo docker version + sudo docker compose version + sudo docker ps --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}' + sudo docker network ls +else + printf '%s\n' 'Docker is not installed' +fi +``` + +提供这些检查结果及 RDS/Tair 内网地址、实际端口、VPC 和 TLS 状态,确认专用库/账号与白名单是否完成。密码、私钥、完整 `.env` 和 Docker 环境变量不要发送。若地址或资源名称涉及其他业务,可先脱敏。 + +先确认 Docker 已有容器、网段、宿主机端口与旧服务不冲突,再安装 Docker/Compose、上传并校验发布包、填写 `.env.cloud`、检查 RDS/Tair 连接。宿主机不需要单独安装 Nginx、Java、Node、PostgreSQL 或 Redis;前端容器已经包含 Nginx。 + +各节点验收:基础环境及 SSH 可管理 → RDS/Tair 连通及鉴权 → 容器就绪及隧道访问 → 域名 HTTPS → 登录、Key 权限、Mock 请求、审计导出及真实同步调用。没有实际执行服务器命令和验收前,不将本地构建或文档完成视为已部署。 ### RDS PostgreSQL 15