🔌 VS Code 远程连接开发服务器 · 完整指南

基于 SSH 密钥认证 + 非标准端口(2222)的配置流程

本指南将带你完成从 本地生成 SSH 密钥 到 服务器端用户配置,再到 VS Code Remote-SSH 连接 的全过程。适用于 Linux 开发服务器(Ubuntu/CentOS)与 Windows / macOS / Linux 客户端。

📁 第一步:本地生成 SSH 密钥对

🖥️ 在您的本地电脑(Windows / macOS / Linux)上操作

打开终端(Windows 可使用 PowerShell 或 Git Bash),执行以下命令生成 ED25519 密钥(推荐,更安全更快):

ssh-keygen -t ed25519 -C "your_email@example.com"

生成后,在 ~/.ssh/ 目录下得到两个文件:

💡 提示: 如果已有密钥对,可跳过此步。但建议每个设备使用独立的密钥。

📤 第二步:将公钥提供给服务器管理员

📋 复制公钥内容

执行以下命令查看并复制公钥(整行,以 ssh-ed25519 开头):

cat ~/.ssh/id_ed25519.pub

将输出的内容发送给服务器管理员(或如果您有权限,自行进行下一步)。

⚠️ 注意: 请确保复制完整,不包含额外换行或空格。

👤 第三步:服务器端创建用户并配置公钥

🛠️ 管理员在服务器(如 172.16.0.67)上操作(需 root 或 sudo 权限)

3.1 创建系统用户

useradd -m -s /bin/bash <用户名>
passwd <用户名>   # 设置初始密码(后续可用密钥登录)

例如创建用户 zhangsan:

useradd -m -s /bin/bash zhangsan
passwd zhangsan

3.2 添加用户到 docker 组(如需执行 docker 命令)

usermod -aG docker <用户名>

3.3 创建 .ssh 目录并设置权限

mkdir -p /home/<用户名>/.ssh
chmod 700 /home/<用户名>/.ssh

3.4 将公钥写入 authorized_keys

将用户提供的公钥内容(一行)追加到 ~/.ssh/authorized_keys:

echo "ssh-ed25519 AAA... 用户公钥" >> /home/<用户名>/.ssh/authorized_keys
chmod 600 /home/<用户名>/.ssh/authorized_keys
chown -R <用户名>:<用户名> /home/<用户名>/.ssh

3.5 确认 SSH 服务配置允许公钥认证

检查 /etc/ssh/sshd_config 包含:

PubkeyAuthentication yes
AuthorizedKeysFile .ssh/authorized_keys

修改后重启 SSH 服务:

systemctl restart sshd   # 或 service ssh restart
🔐 安全建议: 如果服务器对外暴露,建议禁用密码登录(PasswordAuthentication no),仅允许密钥认证。

🔗 第四步:配置本地 SSH 客户端(可选但推荐)

📝 编辑本地 ~/.ssh/config 文件

创建或编辑 ~/.ssh/config(Windows 路径:C:\Users\你的用户名\.ssh\config),添加以下内容(注意端口若为 2222 则需指定):

Host dev-server
    HostName 172.16.0.67
    User <你的用户名>
    Port 2222
    IdentityFile ~/.ssh/id_ed25519

保存后,即可使用 ssh dev-server 快速连接。

💡 说明: Port 需与 Gitea/SSH 服务实际端口一致(本例为 2222)。
IdentityFile 指向你的私钥路径。

✅ 第五步:测试 SSH 连接

🧪 在本地终端执行

ssh -T dev-server   # 或 ssh -T git@172.16.0.67 -p 2222

如果配置成功,应直接进入服务器(或显示认证成功信息),无需输入密码。

⚠️ 常见问题排查:
  • Permission denied (publickey) → 公钥未正确添加到服务器,或私钥路径错误。
  • Connection refused → 端口错误或防火墙未开放。
  • WARNING: UNPROTECTED PRIVATE KEY FILE → 私钥权限过宽,需执行 chmod 600 ~/.ssh/id_ed25519。

💻 第六步:VS Code 远程连接

🚀 使用 Remote-SSH 插件

  1. 在 VS Code 中安装 Remote-SSH 插件(如未安装)。
  2. 按 F1,输入并选择 “Remote-SSH: Connect to Host...”。
  3. 选择 dev-server(或输入完整地址 ssh://git@172.16.0.67:2222)。
  4. 首次连接会提示确认主机指纹,选择 “Continue”。
  5. VS Code 将自动在服务器上安装 VS Code Server,稍等片刻。
  6. 连接成功后,左下角状态栏显示 “SSH: dev-server”。
📌 提示: 如果连接后需要打开项目文件夹,点击 “打开文件夹” 并选择如 /opt/shortdrama 等目录。

🧩 使用 Dev Container(如项目配置了 .devcontainer)

连接后,如果项目根目录存在 .devcontainer 文件夹,VS Code 通常会提示 “Reopen in Container”。点击后,将在 Docker 容器中构建开发环境,获得完全一致的开发体验。

若未提示,可按 F1 → “Dev Containers: Reopen in Container” 手动触发。


📌 附录:常用命令速查

生成密钥
ssh-keygen -t ed25519 -C "email"
查看公钥
cat ~/.ssh/id_ed25519.pub
测试 SSH 连接
ssh -T git@172.16.0.67 -p 2222
VS Code 连接
F1 → Remote-SSH: Connect to Host...
🛠️ 短剧 APP 开发环境 · 远程开发配置指南