还在本地跑不动大项目?服务器闲置吃灰?来吧展示,教你用 VS Code Remote 把服务器变成你的私人云服务器,本地写代码,远程运行,爽到飞起!
前几天有个粉丝私信问我:"老李,我买了台云服务器,除了部署网站还能干啥?"很多人买了服务器就用来跑个博客、挂个脚本,太浪费了!今天我来分享一个超实用的玩法:用 VS Code Remote 连接服务器,在本地写代码,直接在服务器上运行。本地电脑配置低?没关系!代码在服务器上跑,你的笔记本只需要能打开 VS Code 就行。
为啥要用 VS Code Remote?
先说好处,不然你没动力往下看:
- 环境统一:服务器配好一次环境,随时随地开发,不用在多台电脑上重复配置
- 性能解放:编译、运行都在服务器上,本地电脑不发热不卡顿
- 代码不丢:代码直接存在服务器,电脑坏了也不影响
- 团队协作:多人连同一台服务器,环境一致,减少"在我机器上能跑"的尴尬
- 24 小时运行:跑定时任务、爬虫、训练模型,本地电脑关了也能继续
是不是心动了?来,开干!
准备工作
服务器要求
- 一台 Linux 服务器(CentOS 7+ / Ubuntu 18.04+ / Debian 10+)
本地要求
- 安装好 VS Code(下载地址:https://code.visualstudio.com)
检查 SSH 服务
先确保服务器 SSH 是开着的:
# 查看 SSH 状态systemctl status sshd# 如果没运行,启动它sudo systemctl start sshdsudo systemctl enable sshd
安装 VS Code Remote 插件
这一步超简单:打开 VS Code,左侧点击"扩展"图标(或按 Ctrl+Shift+X),搜索 ,Remote - SSH,点击安装(Microsoft 官方出品,认准蓝色图标),装好后,左下角会出现一个绿色的小箭头图标,这就是 Remote 的入口。
配置 SSH 连接
生成 SSH 密钥(推荐)
用密码登录太麻烦,咱用密钥登录,一次配置终身爽:
# 本地电脑执行,生成密钥对ssh-keygen -t ed25519 -C "your_email@example.com"# 一路回车就行,默认存在 ~/.ssh/id_ed25519
把公钥传到服务器
# 把公钥复制到服务器ssh-copy-id root@你的服务器 IP# 或者手动复制cat ~/.ssh/id_ed25519.pub | ssh root@你的服务器 IP "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys"
测试连接
ssh root@你的服务器 IP
能直接登录不输密码,就对了!
在 VS Code 里添加主机
- 点击左下角绿色箭头 →
Remote-SSH: Connect to Host... - 选择配置文件(默认
~/.ssh/config 就行) - 再次点击绿色箭头 → 选择你刚添加的主机 → 连接
第一次连接会提示安装 Remote Server,点"Install"就行,VS Code 会自动在服务器上安装服务端。
等个几十秒,连接成功后,左下角会显示 SSH: 你的服务器 IP,窗口标题也会变成 Remote: SSH。
恭喜!你现在已经连上服务器了!
在服务器上配置开发环境
连上之后,你就可以像在本地一样操作了。来,配个基础开发环境:
安装常用工具
# Ubuntu/Debiansudo apt updatesudo apt install -y git curl wget vim net-tools htop# CentOSsudo yum install -y git curl wget vim net-tools htop
安装 Docker(可选但推荐)
# 一键安装 Dockercurl -fsSL https://get.docker.com | bash# 启动 Dockersudo systemctl start dockersudo systemctl enable docker# 把当前用户加入 docker 组,不用每次输 sudosudo usermod -aG docker $USER# 退出重连,让组权限生效exit
安装 Node.js / Python / Go(按需)
# Node.js(用 nvm 管理版本)curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bashsource ~/.bashrcnvm install --lts# Python 3(一般系统自带,检查版本)python3 --version# Go 语言wget https://go.dev/dl/go1.21.0.linux-amd64.tar.gzsudo tar -C /usr/local -xzf go1.21.0.linux-amd64.tar.gzecho'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrcsource ~/.bashrc
实战:在服务器上跑个项目
来,整个活的,克隆个项目跑起来:
# 创建项目目录mkdir -p ~/projectscd ~/projects# 克隆一个示例项目git clone https://github.com/your-username/your-project.git# 在 VS Code 里打开这个文件夹# 文件 → 打开文件夹 → 选择 ~/projects/your-project
现在你可以在 VS Code 里编辑代码,终端里直接运行,文件保存在服务器上,完美!
进阶技巧
端口转发:访问服务器上的 Web 服务
服务器上跑了个服务,本地想访问?VS Code 自动帮你转发:
- 在服务器终端运行:
python3 -m http.server 8000 - VS Code 右下角会弹出提示,点击"在浏览器中打开"
- 本地浏览器访问
http://localhost:8000 就能看到了
多窗口工作
可以开多个 VS Code 窗口,一个连服务器 A,一个连服务器 B,或者一个远程一个本地,互不干扰。
配置文件同步
VS Code 的设置可以同步,但有些插件可能只想在远程用。在设置里区分一下:
settings.json- 远程窗口有独立的
settings.json,可以单独配置
常见问题
Q: 连接超时怎么办?
A: 检查服务器防火墙,确保 22 端口开放:
# Ubuntu ufwsudo ufw allow 22# CentOS firewallsudo firewall-cmd --permanent --add-port=22/tcpsudo firewall-cmd --reload
Q: 卡顿怎么办?
A: 网络问题,试试:
- 在
~/.ssh/config 里加 ServerAliveInterval 60
Q: 服务器重启后要重新连接吗?
A: 对,但不需要重新配置。点击左下角绿色箭头,选择你的主机,重新连就行。
完美总结
用 VS Code Remote 把服务器变成开发机,真香警告!
核心步骤就三步:
本地电脑再烂也不怕,代码在服务器上跑,你只需要一个能打开 VS Code 的设备。赶紧试试,有问题评论区留言!觉得有用,记得分享给需要的朋友!