本指南将带你完成从 本地生成 SSH 密钥 到 服务器端用户配置,再到 VS Code Remote-SSH 连接 的全过程。适用于 Linux 开发服务器(Ubuntu/CentOS)与 Windows / macOS / Linux 客户端。
打开终端(Windows 可使用 PowerShell 或 Git Bash),执行以下命令生成 ED25519 密钥(推荐,更安全更快):
ssh-keygen -t ed25519 -C "your_email@example.com"
~/.ssh/id_ed25519)。生成后,在 ~/.ssh/ 目录下得到两个文件:
id_ed25519 —— 私钥(严禁泄露)id_ed25519.pub —— 公钥(可公开,用于服务器认证)执行以下命令查看并复制公钥(整行,以 ssh-ed25519 开头):
cat ~/.ssh/id_ed25519.pub
将输出的内容发送给服务器管理员(或如果您有权限,自行进行下一步)。
useradd -m -s /bin/bash <用户名> passwd <用户名> # 设置初始密码(后续可用密钥登录)
例如创建用户 zhangsan:
useradd -m -s /bin/bash zhangsan passwd zhangsan
usermod -aG docker <用户名>
mkdir -p /home/<用户名>/.ssh chmod 700 /home/<用户名>/.ssh
将用户提供的公钥内容(一行)追加到 ~/.ssh/authorized_keys:
echo "ssh-ed25519 AAA... 用户公钥" >> /home/<用户名>/.ssh/authorized_keys chmod 600 /home/<用户名>/.ssh/authorized_keys chown -R <用户名>:<用户名> /home/<用户名>/.ssh
检查 /etc/ssh/sshd_config 包含:
PubkeyAuthentication yes AuthorizedKeysFile .ssh/authorized_keys
修改后重启 SSH 服务:
systemctl restart sshd # 或 service ssh restart
PasswordAuthentication no),仅允许密钥认证。
创建或编辑 ~/.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 -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。F1,输入并选择 “Remote-SSH: Connect to Host...”。dev-server(或输入完整地址 ssh://git@172.16.0.67:2222)。/opt/shortdrama 等目录。
连接后,如果项目根目录存在 .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 -T git@172.16.0.67 -p 2222
F1 → Remote-SSH: Connect to Host...