Atheos v601 介绍与选型指南
Atheos v601 联网溯源介绍:Codiad 后继的自托管浏览器云端 IDE(PHP+JSON 平面文件,无数据库),含功能特性、适用场景限制与 code-server/Che/Theia 量化选型对比。
Atheos v601 介绍与选型指南
目标:说清 Atheos 是什么、解决什么问题、与同类云端 IDE 如何取舍。本文全部结论来自官方渠道联网溯源(官网 atheos.io、GitHub 仓库 Atheos/Atheos、Docker Hub hlsiira/atheos,查询日期 2026-10-27),不含本地实测内容。
一、环境信息
- 溯源日期:2026-10-27
- 溯源渠道:GitHub 仓库页
github.com/Atheos/Atheos、Releases/Tags 页、Docker Hubhub.docker.com/r/hlsiira/atheos、官网atheos.io、shields.io 星数徽章 - 最新稳定版本:v601(发布于 2025-01-10)
- 主分支开发线版本号:611(仓库根
.version文件,查询日期 2026-10-27) - 软件形态:PHP Web 应用(LAMP 栈,浏览器访问),无独立守护进程、无数据库依赖
二、软件概述
Atheos 是一款自托管的浏览器端云端 IDE(Cloud IDE),是经典项目 Codiad 的现代化重写与官方后继。官方仓库自述为 "A self-hosted browser-based cloud IDE, updated from Codiad IDE"(GitHub 仓库描述,查询日期 2026-10-27)。
Codiad 诞生于 2012 年前后,以「极小 footprint、极简依赖」著称,但项目早已停滞——GitHub 仓库 Codiad/Codiad 当前处于 archived(已归档) 状态,最后一次 Release 为 v.2.8.4(2013-10-26,来源:GitHub Releases 页,查询日期 2026-10-27)。Atheos 由 Codiad 社区成员(主要维护者 Liam Siira / @HLSiira)发起,在 Codiad 代码基础上做了几乎全面的重写,并持续维护至今。
⚠️ 注意:任务线索中「疑为 Codiad 后继」经实查确认属实——Atheos 确为 Codiad 的维护中重写分支,且 Codiad 原仓库已归档停更,选型时应直接选择 Atheos。
核心身份要素(来源:GitHub 仓库与官网,查询日期 2026-10-27):
| 要素 | 取值 |
|---|---|
| 开源协议 | MIT(仓库 README 徽章与 docs/LICENSE.md) |
| 技术栈 | PHP(服务端)+ 原生 JavaScript(前端,已完全移除 jQuery) |
| 数据存储 | 无数据库,用户/项目/配置一律落 JSON 平面文件(data/ 目录) |
| 运行依赖 | 任意 Web 服务器(Apache2/Nginx)+ PHP,POSIX 文件系统 |
| 部署形态 | 传统 LAMP 部署 / 官方 Docker 镜像 hlsiira/atheos |
| 默认端口 | 由 Web 服务器决定(通常 80/443) |
三、核心架构
Atheos 的架构刻意保持「极简 + 标准化」,整体是一个经典的无数据库 PHP Web 应用:
- 服务端(PHP):入口
index.php(页面)与controller.php(全部 AJAX 请求的统一路由,按target+action分发到components/<模块>/controller.php)。功能按组件化组织,目录即模块:components/(内置组件:user、project、filemanager、editor、git、marketplace、update 等)、plugins/(市场插件)、modules/、traits/、libraries/。 - 前端(原生 JS):Codiad 时代的 jQuery 及插件被完全移除,前端重写为原生 JavaScript 模块化实现(官方 README 列举的与 Codiad 最显著差异之一),静态资源构建产物在
public/(modules.min.js、libraries.min.js等)。 - 存储层(JSON 平面文件):账号、项目、权限、分析数据全部以 JSON 文件存放在
data/目录(如data/users.json),项目代码存放在workspace/。没有 MySQL/PostgreSQL 等任何数据库依赖——这是 Atheos 与 code-server/Eclipse Che 等重型方案的最大差异点。 - 请求模型:相对 Codiad 全面从 GET 改为 POST 请求,并带 CSRF/会话校验;用户系统带权限模型(
configure/read/write三档权限 + ACL)。
💡 技术拓展:浏览器端 IDE 的服务端实现路线主要有三类——
路线 代表 特点 PHP 平面文件 Atheos、Codiad、ICEcoder 依赖极小,任意虚拟主机可跑,无数据库 完整 IDE 后端服务化 code-server(VS Code)、Eclipse Theia 功能最全,但内存/CPU 开销大(Node 进程常驻数百 MB) k8s 原生工作区编排 Eclipse Che、Coder、Gitpod(自托管版) 每用户独立工作区容器,功能强但必须有 k8s/容器编排基础设施 Atheos 属于第一类:牺牲智能补全等重功能,换取「一台 1C512M 的 VPS 甚至虚拟主机就能跑」的极致轻量。
四、功能特性
依据官方 README 与 v601 Release Notes(查询日期 2026-10-27),Atheos 相对 Codiad 的主要能力与差异:
- 代码编辑:基于浏览器编辑器,支持语法高亮、多标签、分屏;面向「快速交互式开发」而非重型 IDE 全家桶。
- 内置 Git 集成(CodeGit):组件内置 Git 支持(提交、历史、amend 等),v601 仍在持续修复 CodeGit 相关问题(#246、#262、#263)。
- 用户与权限系统:多用户、每用户权限(configure/read/write)与项目级 ACL,比 Codiad 更完整。
- 插件市场(Marketplace):内置插件/主题市场(
MARKETURL指向 atheos.io/market),插件目录化开发,官方鼓励「学会一个组件的结构即学会全部组件」。 - 多语言界面:
languages/目录内置 16 种语言包(含中文 cn.json,另有 bg/cz/de/en/es/fr/hu/it/ja/nl/pl/pt/ro/ru 等,实查 v601 包内清单)。 - 主题与图标主题:默认 dark 主题,favicons 提供 blue/green/red 三套图标主题。
- 更新检查:内置更新检查(
UPDATEURL),但不自动升级,升级需管理员手工覆盖文件(官方 README 明确说明)。 - 安全基线:默认输出 HSTS/X-Frame-Options/X-XSS-Protection 等安全响应头;v601 的核心主题就是安全修复——安全研究员 @WangYihang 发现并上报了多处认证后路径穿越漏洞,v601 集中修复(官方 Release Notes 原文,2025-01-10)。
五、快速开始(最小可用示例)
以下两条路径均来自官方文档(来源:仓库 docs/README.md 与 docs/installation/index.md,查询日期 2026-10-27),具体实测步骤见本专栏部署篇。
Docker(官方镜像,一条命令):
docker run --rm -p 8080:80 -d hlsiira/atheos:latest
# 浏览器打开 http://localhost:8080,进入初始化安装页
传统 LAMP(官方推荐形态):
# 在 Apache+PHP 的 Ubuntu 服务器上
sudo rm -rf /var/www/html/*
sudo git clone https://github.com/atheos/atheos /var/www/html/
sudo chown www-data:www-data -R /var/www/html/
# 浏览器打开 http://<服务器IP>/ 完成初始化(创建管理员、首个项目、时区)
⚠️ 注意:Atheos 官方明确提示「仅在 Unix 文件系统的真实服务器上测试过」,Windows 本地 WAMP 集成包大概率出现路径问题(docs/installation/index.md 原文);安装页会对缺失依赖(zip/openssl/mbstring 扩展)给出告警。
六、适用场景与限制
适用场景:
- 轻量自托管云端 IDE:个人/小团队在一台低配 VPS 上提供浏览器编码环境,随处改代码。
- 教学与临时演示环境:无需为每个学员装桌面 IDE,开一个账号即用。
- 服务器端就地编辑:直接在托管代码所在的服务器上编辑、Git 提交,省掉本地-服务器同步环节。
- 虚拟主机/共享主机用户:无 root、无数据库也能部署(PHP + 可写目录即可)。
明确限制(依据官方文档与架构事实):
- 无智能语言服务:没有 LSP、智能补全、重构等重型 IDE 能力(对比 code-server 的完整 VS Code 体验差距明显)。
- 无数据库即无中心审计:账号/项目数据是 JSON 文件,规模一大(数百用户)管理与备份粒度较粗。
- 升级需手工:没有自动升级系统,升级 = 备份
config.php/data/workspace/plugins/themes后覆盖新文件(官方 README 原文)。 - 桌面/移动端体验:面向桌面浏览器;无移动端适配承诺。
- Windows 服务端不受支持:官方仅声明在 Unix 文件系统服务器测试。
七、同类选型对比
量化维度均来自公开渠道实查(星数为 shields.io/GitHub 仓库页徽章,查询日期 2026-10-27;版本节奏来自各项目 Releases 页):
| 维度 | Atheos | Codiad(前身) | code-server | Eclipse Che | Eclipse Theia |
|---|---|---|---|---|---|
| GitHub 星数 | 680 | 2.8k(已归档) | ~70k 量级 | ~7k 量级 | ~20k 量级 |
| 最新发布 | v601(2025-01-10) | v.2.8.4(2013,停更) | 持续月度发版 | 持续发版(仅 k8s) | 持续月度发版 |
| 最近提交活跃度 | 2026-07-20(活跃) | 已归档停更 | 活跃 | 活跃 | 活跃 |
| 技术栈 | PHP + 原生 JS | PHP + jQuery | Node + VS Code | Java/Go + k8s | TypeScript |
| 数据存储 | JSON 平面文件 | JSON 平面文件 | 本地文件 + VS Code 设置 | k8s CRD/PVC | 本地/容器文件 |
| 运行依赖 | PHP+Web 服务器 | PHP+Web 服务器 | 单二进制(内存开销大) | 仅 k8s | 容器/桌面 |
| 资源 footprint | 极小(无常驻进程,PHP-FPM 共享) | 极小 | 中等(常驻 Node,数百 MB) | 大(需 k8s 集群) | 中等 |
| 智能补全/LSP | 无 | 无 | 完整 VS Code 生态 | 完整 | 完整 |
| 多用户 | 内置(JSON 账号) | 内置 | 单用户(需配合其他方案) | 企业级多租户 | 需配合 Theia Blueprint 等 |
| 插件市场 | 内置(atheos.io/market) | 有(已停) | VS Code 扩展生态 | 企业级 | Open VSX |
选型建议(「如果…则…」):
- 如果只要「浏览器里改代码」、服务器配置低、不想维护数据库与常驻服务 → 选 Atheos(本类中最轻、仍在维护)。
- 如果看重历史知名度而考虑 Codiad → 否决:Codiad 仓库已归档、十年未发版,直接选其后继 Atheos。
- 如果需要完整 VS Code 体验(智能补全/扩展市场)、能接受单用户与较大内存 → 选 code-server。
- 如果是企业级多租户、已有 k8s 平台 → 选 Eclipse Che / Coder。
- 如果要自建「类 VS Code 产品」做二次开发 → 选 Eclipse Theia 框架。
⚠️ 一票否决级提示:Atheos 自身项目健康度合格(2026 年仍有提交、2025-12 镜像仍在构建),不属于停滞/归档项目;但其前身 Codiad 已归档停更,切勿因搜索结果排名而误装 Codiad。
八、参考链接
- GitHub 仓库(源码/Releases):https://github.com/Atheos/Atheos (查询日期 2026-10-27)
- v601 Release Notes(安全修复说明):https://github.com/Atheos/Atheos/releases/tag/v601 (查询日期 2026-10-27)
- 官网:https://www.atheos.io/ (查询日期 2026-10-27)
- 官方 Docker 镜像:https://hub.docker.com/r/hlsiira/atheos (查询日期 2026-10-27)
- 官方安装文档(仓库内):https://github.com/Atheos/Atheos/tree/main/docs/installation (查询日期 2026-10-27)
- Codiad 原仓库(已归档):https://github.com/Codiad/Codiad (查询日期 2026-10-27)