自建 code-server vs CloudStudio：为什么插件不能用？
# 自建 code-server vs CloudStudio：为什么插件不能用？
## 问题背景
办公室有一台 Lubuntu 电脑，安装了 code-server，通过内网穿透在家的浏览器可以正常访问和使用。但是有两个问题：
- CodeBuddy 插件无法使用
- MySQL 插件无法使用
---
## 一、code-server 插件无法使用的根本原因
### 浏览器远程访问的架构限制
```
┌─────────────────────────────────────────────────────────────┐
│ Lubuntu (办公室) │
│ ┌──────────────┐ ┌──────────────┐ ┌───────────────┐ │
│ │ code-server │ │ 插件运行时 │ │ MySQL │ │
│ │ Web 服务 │ │ (Browser │ │ 3306 │ │
│ │ 8443 │ │ WebView) │ │ (内网可达) │ │
│ └──────┬───────┘ └──────┬───────┘ └───────┬───────┘ │
└─────────┼───────────────────┼───────────────────┼───────────┘
↓ ↓ ↓
┌─────────┴───────────┐ ┌──────┴────────┐ ┌──────┴────────┐
│ 你家浏览器 │ │ 插件网络请求 │ │ MySQL 连接 │
│ (访问 code-server) │ │ 从浏览器发出 │ │ 被 CORS/ │
│ │ │ 被阻断！ │ │ 防火墙阻断！ │
└────────────────────┘ └──────────────┘ └──────────────┘
```
**核心问题**：插件实际运行在**浏览器沙盒**中，网络请求从浏览器发出，被跨域限制和防火墙阻断，无法访问办公室内网的 MySQL 等服务。
---
## 二、CloudStudio 能做到的原因
腾讯 CloudStudio 采用了不同的架构设计：
```
┌─────────────────────────────────────────────────────────────┐
│ CloudStudio 服务器（腾讯云） │
│ ┌──────────────┐ ┌──────────────┐ ┌───────────────┐ │
│ │ code-server │ ←→│ 插件代理层 │ ←→│ MySQL/其他 │ │
│ │ + 插件运行时 │ │ Plugin Host │ │ 服务 │ │
│ └──────────────┘ └──────────────┘ │ (同在内网) │ │
│ └───────┬───────┘ │
└────────────────────────────────────────────────┼───────────┘
↓
┌───────────────────────────┐
│ 你家浏览器（纯显示） │
│ 只负责渲染 UI │
└───────────────────────────┘
```
**关键差异**：
- CloudStudio 的插件运行在**腾讯云服务器**上，与 MySQL 等服务在同一个内网
- 插件请求从云服务器发出，可以直接访问内网资源
- 浏览器只负责显示，不需要运行任何插件逻辑
---
## 三、解决方案对比
| 方案 | 客户端要求 | 插件支持 | 成本 | 难度 |
|------|-----------|---------|------|------|
| **CloudStudio** | 纯浏览器，无需安装 | 完美 | 免费额度/付费 | ⭐ 最简单 |
| **VS Code Remote SSH** | 需要安装 VS Code 桌面版 | 完美 | 免费 | ⭐⭐ |
| **自建 code-server** | 纯浏览器 | 受限 | 免费 | ⭐⭐⭐⭐ |
| **自建插件代理** | 纯浏览器 | 可行 | 自研成本高 | ⭐⭐⭐⭐⭐ |
### 方案一：使用 CloudStudio（最终选择）
**访问地址**：https://cloudstudio.cloud.tencent.com/
**优势**：
- 纯浏览器访问，无需安装任何软件
- 插件运行在云端，与内网服务无障碍通信
- 腾讯云官方服务，稳定可靠
**注意事项**：
- MySQL 需要公网可达，或通过内网穿透暴露
- 每月有免费时长，超出部分收费
### 方案二：VS Code Remote SSH
如果愿意在客户端安装 VS Code，这也是一个很好的选择：
**客户端要求**：
- Windows/macOS/Linux 安装 VS Code 桌面版
- 安装 "Remote - SSH" 扩展
- SSH 服务可从家访问到办公室 Lubuntu
**工作原理**：
```
你家 VS Code ←─SSH 隧道──→ Lubuntu VS Code Server
(插件在本地运行) (文件/内网访问在远程)
```
---
## 四、结论
对于「纯浏览器访问 + 完整插件支持」的需求，**CloudStudio 是最简单可靠的方案**。它的插件代理架构解决了浏览器沙盒限制的问题，让插件可以自由访问内网资源。
如果对客户端安装软件不介意，**VS Code Remote SSH** 是更好的长期方案，性能更佳且完全免费。
---
*整理自 2026年4月19日 技术讨论*