甲骨文 ARM 神机打造云端 IDE (Code-Server) 避坑全记录

拥有 4核24G 的甲骨文 ARM 实例,如果只用来跑 WordPress 实在太浪费了。本文将带你把这台神机变成一个随时随地可访问的“云端 VS Code”。我们将绕过宝塔软件商店的坑,手动部署 Code-Server,并彻底解决反向代理中的 WebSocket 1006 报错。

一、 序言:为什么是 Code-Server?

对于开发者来说,能在浏览器里直接操作服务器文件、编写代码、运行终端,是一件极其优雅的事情。配合我们之前优化的 日本大阪直连线路 和 BBR 加速,这种云端编写代码的体验几乎可以媲美本地操作。

二、 避坑指南:为什么不建议使用宝塔一键安装?

宝塔软件商店里的 Code-Server 插件大多是为 x86 架构准备的。在甲骨文 ARM (aarch64) 架构下安装,经常会出现:

  1. 启动闪退: 二进制文件不兼容。
  2. 版本过旧: 无法使用最新的 VS Code 插件。
  3. 权限混乱: 普通用户无法直接编辑 /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

为什么要用反向代理?

  1. HTTPS 安全: 现代浏览器(如 Chrome/Edge)要求在 HTTPS 环境下才允许使用剪贴板(即 Cmd+C / V 复制粘贴功能)。
  2. 域名访问: 无需记住复杂的 IP 和端口。

操作流程:

  1. 在宝塔新建一个纯静态网站(如 code.bigengwu.cn)。
  2. 申请 Let’s Encrypt 证书并开启 “强制 HTTPS”
  3. 在“反向代理”中添加规则,目标 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 界面内切换(如果重启后还是英文)

有时候插件装好了,但系统没有自动切换语言。你可以手动“召唤”出语言设置:

  1. 在 Code-Server 网页界面,按下快捷键:Command + Shift + P(或者 F1)打开命令面板。
  2. 在输入框里输入:display。
  3. 选择 Configure Display Language (配置显示语言)。
  4. 在下拉菜单里选择 zh-cn (中文简体)。
  5. 此时界面会提示你 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

霍欣标的头像霍欣标站长
上一篇 2026-05-24 12:42
下一篇 2026-05-28 07:18

相关推荐

博主人懒,应管局要求暂不开启站内私信和评论功能,如需帮助请发邮件。

邮箱账号:1969600480@qq.com