需先安装node.js（推荐v18/v20），再用npm全局安装code-server；接着配置systemd服务实现后台运行；也可手动下载二进制文件部署；最后建议通过nginx反向代理并启用https保障安全。
如果您希望在Linux服务器上部署code-server以实现Web端访问VSCode功能，则需通过命令行完成服务安装、配置与启动。以下是完成此部署的步骤：
一、使用包管理器安装Node.js和npm
code-server依赖Node.js运行时环境，需先确保系统中已安装兼容版本（推荐v18或v20）。部分Linux发行版仓库中的Node.js版本过旧，可能引发兼容性问题，因此建议优先采用官方NodeSource仓库安装。
1、执行命令添加NodeSource APT源（以Ubuntu/Debian为例）：curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
2、运行apt更新并安装Node.js：sudo apt update && sudo apt install -y nodejs
3、验证安装结果：node --version && npm --version
二、通过npm全局安装code-server
npm是Node.js默认包管理工具，可直接从npm registry拉取最新稳定版code-server二进制文件并完成本地部署，无需编译，适合快速启用。
1、执行全局安装命令：sudo npm install -g code-server
2、确认安装路径是否纳入系统PATH：which code-server
3、检查版本信息以验证完整性：code-server --version
三、使用systemd配置后台服务
将code-server注册为systemd服务可实现开机自启、进程守护及日志统一管理，避免终端关闭导致服务中断，适用于生产环境长期运行。
1、创建服务定义文件：sudo nano /etc/systemd/system/code-server.service
2、写入以下内容（请替换YOUR_USERNAME为实际用户，/home/YOUR_USERNAME为对应家目录路径）：[Unit]\nDescription=code-server\nAfter=network.target\n\n[Service]\nType=simple\nUser=YOUR_USERNAME\nWorkingDirectory=/home/YOUR_USERNAME\nExecStart=/usr/local/bin/code-server --auth=password --bind-addr 0.0.0.0:8080 --cert /home/YOUR_USERNAME/.local/share/code-server/cert.pem --cert-key /home/YOUR_USERNAME/.local/share/code-server/key.pem\nRestart=always\nRestartSec=10\n\n[Install]\nWantedBy=multi-user.target
3、重载systemd配置并启用服务：sudo systemctl daemon-reload && sudo systemctl enable --now code-server
四、手动下载预编译二进制文件运行
当系统无法访问npm registry或受限于网络策略时，可跳过npm安装流程，直接从GitHub Releases页面获取对应架构（如x86_64或aarch64）的静态二进制文件，解压即用，不依赖Node.js全局环境。
1、进入临时目录并下载最新release（以v4.29.0为例）：cd /tmp && curl -fOL https://github.com/coder/code-server/releases/download/v4.29.0/code-server-4.29.0-linux-amd64.tar.gz
2、解压并移动至/usr/local/bin：tar -xzf code-server-*.tar.gz && sudo mv code-server-*/code-server /usr/local/bin/
3、赋予可执行权限并测试启动：sudo chmod +x /usr/local/bin/code-server && code-server --port 8080 --auth password
五、配置反向代理与HTTPS访问
直接暴露code-server端口存在安全风险，建议通过Nginx或Caddy作为反向代理，绑定域名并启用TLS加密，同时可复用HTTP基本认证或集成OAuth登录机制。
1、安装Nginx（如未安装）：sudo apt install -y nginx
2、创建站点配置文件：sudo nano /etc/nginx/sites-available/code-server
3、填入含SSL终止与路径重写的配置（需提前准备证书路径）：server {\n listen 443 ssl;\n server_name ide.example.com;\n ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;\n ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;\n location / {\n proxy_pass http://127.0.0.1:8080/;\n proxy_set_header Upgrade $http_upgrade;\n proxy_set_header Connection upgrade;\n proxy_set_header Accept-Encoding gzip;\n }\n}
