From 54228e05ab73e95a07c8b9c9a483b6267f1d18c1 Mon Sep 17 00:00:00 2001 From: WangLX <519407855@qq.com> Date: Mon, 14 Sep 2026 21:46:55 +0800 Subject: [PATCH] docs: clarify team SSH access for server deployment --- docs/11-server-test-deployment.md | 36 ++++++++++++++++++++++++++++++- 1 file changed, 35 insertions(+), 1 deletion(-) diff --git a/docs/11-server-test-deployment.md b/docs/11-server-test-deployment.md index d1eb836..03c4dc8 100644 --- a/docs/11-server-test-deployment.md +++ b/docs/11-server-test-deployment.md @@ -32,13 +32,47 @@ ### 防火墙和网段 -- SSH 22 仅允许办公公网 IP;先保持当前会话并验证新登录通路,再收紧来源,避免锁出。 +- SSH 22 是远程维护端口。开发团队网络可能变化,本次测试可以像现有服务器一样配置 TCP 22、来源 `0.0.0.0/0`,但必须配合每人独立账号、个人 SSH 公钥、禁用密码登录和禁止 root 直登;不要共用 root 密码或私钥。长期建议改为只允许公司 VPN/堡垒机出口 IP。 - SSH 隧道模式不需要开放 80/443/8080。HTTPS 模式开放 80、443;内部测试阶段建议也仅允许测试人员公网 IP。 - Java 8787、数据库端口、6379 不发布到公网;8080 始终只绑定 `127.0.0.1`。 - 不只依赖 UFW:Docker 发布端口的流量可能绕过 UFW,阿里云防火墙来源限制必须配置。[Docker 官方说明](https://docs.docker.com/engine/install/ubuntu/) - 当前服务器在 `172.17.*` 私网,而 Docker 默认桥接网络也可能使用 `172.17.0.0/16`。安装前后查看 `ip route`;若重叠,先调整 Docker 地址池/默认桥接网段,再启动。不要直接覆盖已有 `/etc/docker/daemon.json`。 - 本 Compose 显式使用 `10.253.240.0/24`,但这只是待确认候选值。须确保不与服务器、RDS、Tair、现有 Docker/VPC 路由重叠;必要时修改 `MOYI_DOCKER_SUBNET`。脚本会检查该子网与已解析的 RDS/Tair 地址是否重叠,不代替完整路由审查。 +### 团队 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) + +服务器上逐位成员创建账号和公钥。以下示例中的账号和公钥替换为真实值,不要把私钥上传到服务器: + +```bash +# 使用当前已验证的管理员会话执行;先不要关闭当前窗口 +sudo adduser --disabled-password --gecos "" moyi-dev1 +sudo usermod -aG sudo moyi-dev1 # 只有需要服务器管理权限的开发者才加入 sudo +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 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 加固: + +```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' +PermitRootLogin no +PasswordAuthentication no +KbdInteractiveAuthentication no +PubkeyAuthentication yes +EOF +sudo sshd -t +sudo systemctl reload ssh +``` + +保留阿里云 Workbench/VNC 救援入口和至少一个已验证的 sudo 会话。成员离职或不再参与时,删除其账号或公钥,不要旋转其他成员的密钥。22 对公网开放会收到扫描,建议安装并启用系统安全更新和 `fail2ban`;上线前再迁移到 VPN/堡垒机白名单。 + ### RDS PostgreSQL 15 1. 在现有 RDS 实例创建专用数据库 `moyi_control` 和专用账号 `moyi_app`,**不在小程序库里直接添加本项目的表**。