当前位置:首页>Linux>Linux 服务器搭建个人开发环境:VS Code Remote + Docker,本地写代码远程运行

Linux 服务器搭建个人开发环境:VS Code Remote + Docker,本地写代码远程运行

  • 2026-10-11 08:33:35
Linux 服务器搭建个人开发环境:VS Code Remote + Docker,本地写代码远程运行

还在本地跑不动大项目?服务器闲置吃灰?来吧展示,教你用 VS Code Remote 把服务器变成你的私人云服务器,本地写代码,远程运行,爽到飞起!

前几天有个粉丝私信问我:"老李,我买了台云服务器,除了部署网站还能干啥?"很多人买了服务器就用来跑个博客、挂个脚本,太浪费了!今天我来分享一个超实用的玩法:用 VS Code Remote 连接服务器,在本地写代码,直接在服务器上运行。本地电脑配置低?没关系!代码在服务器上跑,你的笔记本只需要能打开 VS Code 就行。

为啥要用 VS Code Remote?

先说好处,不然你没动力往下看:

  • 环境统一:服务器配好一次环境,随时随地开发,不用在多台电脑上重复配置
  • 性能解放:编译、运行都在服务器上,本地电脑不发热不卡顿
  • 代码不丢:代码直接存在服务器,电脑坏了也不影响
  • 团队协作:多人连同一台服务器,环境一致,减少"在我机器上能跑"的尴尬
  • 24 小时运行:跑定时任务、爬虫、训练模型,本地电脑关了也能继续

是不是心动了?来,开干!

准备工作

 服务器要求

  • 一台 Linux 服务器(CentOS 7+ / Ubuntu 18.04+ / Debian 10+)
  • 能 SSH 连接(默认 22 端口)
  • 建议 2 核 4G 以上,具体看你跑啥项目

 本地要求

  • 安装好 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 里添加主机

  1. 点击左下角绿色箭头 → Remote-SSH: Connect to Host...
  2. 选择 Add New SSH Host...
  3. 输入连接命令:ssh root@你的服务器 IP
  4. 选择配置文件(默认 ~/.ssh/config 就行)
  5. 再次点击绿色箭头 → 选择你刚添加的主机 → 连接

第一次连接会提示安装 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 自动帮你转发:

  1. 在服务器终端运行:python3 -m http.server 8000
  2. VS Code 右下角会弹出提示,点击"在浏览器中打开"
  3. 本地浏览器访问 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 把服务器变成开发机,真香警告!

核心步骤就三步:

  1. 装 Remote-SSH 插件
  2. 配置 SSH 密钥登录
  3. 连接服务器,开干!

本地电脑再烂也不怕,代码在服务器上跑,你只需要一个能打开 VS Code 的设备。赶紧试试,有问题评论区留言!觉得有用,记得分享给需要的朋友!

最新文章

随机文章