拥有 4核24G 的甲骨文 ARM 实例,如果只用来跑 WordPress 实在太浪费了。本文将带你把这台神机变成一个随时随地可访问的“云端 VS Code”。我们将绕过宝塔软件商店的坑,手动部署 Code-Server,并彻底解决反向代理中的 WebSocket 1006 报错。
一、 序言:为什么是 Code-Server?
对于开发者来说,能在浏览器里直接操作服务器文件、编写代码、运行终端,是一件极其优雅的事情。配合我们之前优化的 日本大阪直连线路 和 BBR 加速,这种云端编写代码的体验几乎可以媲美本地操作。
二、 避坑指南:为什么不建议使用宝塔一键安装?
宝塔软件商店里的 Code-Server 插件大多是为 x86 架构准备的。在甲骨文 ARM (aarch64) 架构下安装,经常会出现:
- 启动闪退: 二进制文件不兼容。
- 版本过旧: 无法使用最新的 VS Code 插件。
- 权限混乱: 普通用户无法直接编辑 /www/wwwroot 目录。
我们的方案: 官方原版脚本安装 + 宝塔 Nginx 反向代理。
三、 实战部署步骤
① 环境准备(解决权限与工具问题)
甲骨文的 Ubuntu 24.04 是精简版。首先,我们需要切换到 root 权限并安装基础编辑器:
sudo -i
apt update && apt install nano -y② 官方脚本一键安装
官方脚本能自动识别 ARM 架构并下载对应的包:
curl -fsSL https://code-server.dev/install.sh | sh③ 配置与安全设置
启动服务以生成配置文件,然后修改它:
systemctl start code-server@root
nano ~/.config/code-server/config.yaml配置要点:
- bind-addr: 127.0.0.1:8080(保持 127.0.0.1,安全起见不暴露 8080 端口到公网)。
- password: 你的密码(设置一个强密码)。
重启生效并设置开机自启:
systemctl enable --now code-server@root
systemctl restart code-server@root四、 进阶:宝塔反向代理与 SSL
为什么要用反向代理?
- HTTPS 安全: 现代浏览器(如 Chrome/Edge)要求在 HTTPS 环境下才允许使用剪贴板(即 Cmd+C / V 复制粘贴功能)。
- 域名访问: 无需记住复杂的 IP 和端口。
操作流程:
- 在宝塔新建一个纯静态网站(如 code.bigengwu.cn)。
- 申请 Let’s Encrypt 证书并开启 “强制 HTTPS”。
- 在“反向代理”中添加规则,目标 URL 指向
http://127.0.0.1:8080。
五、 终极 Boss:解决 WebSocket 1006 报错
这是最容易让人崩溃的一步:登录后弹出 Error: WebSocket close with status code 1006,导致终端无法使用、连接不断刷新。
报错成因:
Nginx 默认不支持 WebSocket 长连接,且宝塔生成的默认配置中存在语法重复冲突。
完美解决方案:
在宝塔的“反向代理配置文件”中,删除原有内容,替换为以下 “防断连终极模板”:
#PROXY-START/
location ^~ /
{
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
# 核心:完美支持 WebSocket
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
# 防止终端挂机超时断开(设置 24 小时)
proxy_read_timeout 86400;
proxy_send_timeout 86400;
# 禁用缓存,确保代码实时性
add_header Cache-Control "no-cache, no-store, must-revalidate";
}
#PROXY-END/特别提醒:如果你保存时提示 duplicate(重复),请检查并删掉代码框下半部分宝塔自动生成的 proxy_http_version 1.1;,确保整个文件里该指令唯一。
六、 总结:从 100ms 响应到云端编程
通过这一系列的操作,我们成功在 甲骨文日本大阪服务器 上搭建了一个生产级别的云端 IDE。
- 体验: 配合 BBR 加速,敲击键盘的反馈几乎没有延迟。
- 安全: 全程 HTTPS 加密,且 Code-Server 只对内网开放。
- 生产力: 配合 root 权限,可以随时通过浏览器修改 WordPress 主题、调整服务器 Nginx 配置,真正做到了“一台电脑,一个浏览器,掌控全局”。
现在,你的 4核24G 神机已经不再仅仅是一个 Web 服务器,它更是一个移动的工作站。开启你的云端编程之旅吧!
七、安装完中文语言包
安装完中文语言包插件后,VS Code 通常会弹出一个右下角的小窗提示你“Restart Now”。如果你错过了那个弹窗,或者想通过后台彻底重启,请按照以下步骤操作:
方法一:通过 Mac 终端执行命令重启(最彻底)
这是最稳妥的方法,确保后台服务完全重新加载。
- ① 在 Mac 终端(确保已 SSH 连上服务器),进入 root 身份(执行
sudo -i)。 - ② 输入以下重启命令:
systemctl restart code-server@root- ③ 等待约 5-10 秒,让服务重新绑定端口。
- ④ 回到浏览器,按下 Command + Shift + R 强制刷新页面。
方法二:在 Code-Server 界面内切换(如果重启后还是英文)
有时候插件装好了,但系统没有自动切换语言。你可以手动“召唤”出语言设置:
- 在 Code-Server 网页界面,按下快捷键:Command + Shift + P(或者 F1)打开命令面板。
- 在输入框里输入:display。
- 选择 Configure Display Language (配置显示语言)。
- 在下拉菜单里选择 zh-cn (中文简体)。
- 此时界面会提示你 Restart (重启),点击它,网页会自动刷新,中文就出来了!
常见问题排查
1. 重启后页面显示白屏或 502?
这是因为服务还没启动完。由于是 4核 ARM 机器,虽然很快,但重新加载所有插件也需要几秒钟。等 10 秒钟再刷新浏览器即可。
2. 插件安装了但找不到 zh-cn 选项?
这说明插件可能没有下载完整(受到网络波动影响)。
- 解决: 在 Code-Server 的插件图标里,找到中文插件,点击 Uninstall 卸载,然后重新点击 Install 安装,再次执行上面的“方法二”。
3. 记得清理浏览器缓存
如果你之前配置了反向代理,浏览器可能会缓存旧的英文界面。安装中文后,建议关闭当前标签页,重新打开一次 https://code.bigengwu.cn。
现在,你的云端 IDE 应该已经是全中文界面,操作起来就跟本地的 VS Code 一模一样了!
作者:霍欣标,如若转载,请注明出处:https://www.bigengwu.cn/shu/399.html