ai-cloud-station
Your Dev Environment Should Never Sleep
项目简介
ai-cloud-station 是一套面向全球协作团队的 AI 云端开发环境一键部署解决方案。通过 Docker 容器化技术，将顶级 AI 编码工具（如 Claude Code、Gemini CLI、OpenAI Codex、Devin 等）和现代开发环境集成在一起，帮助团队成员无论身处何地，都能安全、稳定、高效地使用最强 AI 编码能力。
主要特性
- Python 3.12 系统级集成: 使用系统级 Python 3.12，
python命令直接指向python3，Poetry 和 uv 预装，环境更加简洁稳定。 - 主机网络模式: 容器与主机共享网络命名空间，可直接暴露任意端口，支持 WebSocket、HTTP 等所有协议的透传访问。
- 灵活资源控制: 支持通过
--cpu和--memory参数精确控制容器资源，不指定时默认不限制。 - 便捷别名: 内置
yolo(Claude) 和gyolo(Gemini) 别名，一键启用 AI 全自动执行模式。
核心价值
- 极致易用：一键部署，5 分钟内为每位成员分配专属 AI 云端开发环境。
- 全球可用：突破地域和网络限制，团队成员可随时随地访问。
- 安全合规：代码、AI 认证集中在云端，避免本地泄露和账号风控。
- 高效协作：新成员入职无需复杂配置，环境标准化，极大提升团队效率。
- 开源透明：所有脚本、配置、流程均开源，便于自定义和二次开发。
适用场景
- 跨国/远程/分布式开发团队
- 需要统一 AI 编码环境的企业/创业公司
- 个人开发者希望体验 AI 3.0 时代的云端开发
- 教育/培训/编程教学场景
快速开始
1. 克隆仓库
git clone https://github.com/shareAI-Lab/ai-cloud-station.git
cd ai-cloud-station
2. 构建标准化开发镜像
sudo docker build -t ai-dev-env:latest .
3. 为每位成员一键部署专属环境
chmod +x deploy_user.sh
# 基础用法
./deploy_user.sh 用户名 端口基数
# 指定资源限制
./deploy_user.sh 用户名 端口基数 --cpu 16 --memory 128g
# 示例
./deploy_user.sh xinlu 10 # 端口: 1022(SSH), 1080(VS Code), 1081(VNC)
./deploy_user.sh alice 20 --cpu 2 # 端口: 2022, 2080, 2081, 限制2核CPU
./deploy_user.sh bob 30 --memory 8g # 端口: 3022, 3080, 3081, 限制8GB内存
- 端口基数：两位数字，用于生成唯一端口号，避免容器间冲突
- 脚本会自动生成随机密码、初始化持久化目录、同步AI认证
- 容器使用主机网络模式，服务通过环境变量配置端口
- 不指定资源限制时，容器可使用主机全部资源
- 脚本执行成功后，会输出所有访问方式和凭证
4. 认证同步/批量维护（如有需要）
chmod +x resync_auth.sh
./resync_auth.sh
5. 访问方式
容器使用主机网络模式，服务端口基于端口基数分配：
假设端口基数为 XX，则服务端口为：
- SSH 终端:
ssh dev@YOUR_SERVER_IP -p XX22 - VS Code Web:
http://YOUR_SERVER_IP:XX80 - noVNC 桌面:
http://YOUR_SERVER_IP:XX81 - VNC 原生端口:
59XX(供VNC客户端直连)
示例（端口基数=10）：
- SSH: 端口 1022
- VS Code: 端口 1080
- noVNC: 端口 1081
- VNC: 端口 5910
密码见脚本输出，所有服务使用相同密码。
进阶用法与最佳实践
1. 网络模式与资源限制
- 主机网络模式: 容器使用
--network host模式，可以暴露任意端口，支持 WebSocket、HTTP 等所有协议直接访问。 - 端口分配: 通过端口基数机制自动分配不冲突的端口：
- 建议为每个用户分配不同的端口基数（10、20、30...）
- 端口计算规则：
基数+服务端口后缀（如基数10：1022、1080、1081）
- 资源限制: 通过
--cpu和--memory参数控制资源使用，不指定时默认不限制。./deploy_user.sh user1 10 --cpu 2 --memory 8g # 端口10xx，限制2核CPU，8GB内存 ./deploy_user.sh user2 20 # 端口20xx，不限制资源 - 支持批量部署、批量认证同步，适合 10-50 人团队。
2. 数据持久化与备份
- 所有用户代码、AI 配置均挂载到主机
/srv/user-data/用户名，容器重建不丢数据。 - 建议定期使用
cron任务自动备份/srv/user-data/目录到云存储或 NAS，防止意外丢失。
3. 认证同步与自动化维护
- Claude 认证并非永久有效，管理员可在主机上重新登录后，运行
resync_auth.sh一键同步所有用户认证，无需重启容器。 - 支持一键批量同步，极大降低维护成本。
4. 安全加固建议
- 建议仅开放必要端口，使用防火墙（如 ufw）限制访问来源。
- 推荐为 VS Code Web、noVNC 配置 HTTPS 访问，提升安全性。
- 支持 SSH 密钥认证，进一步提升安全等级。
- 所有认证配置均以只读方式挂载，防止泄露和篡改。
5. 性能与运维建议
- 镜像分层优化，减少构建时间和体积。
- 支持自定义 npm/pip 镜像源，加速依赖安装。
- 推荐定期更新基础镜像和工具，及时打安全补丁。
- 可通过
docker stats、df -h等命令监控资源使用和健康状态。
常见问题（FAQ）
Q1：如何批量为团队成员分配环境？
A：可编写简单的 shell 脚本循环调用 deploy_user.sh，或结合 CI/CD 工具实现自动化。
Q2：Claude 认证失效怎么办？
A：管理员在主机上重新登录 Claude 后，运行 resync_auth.sh 即可一键同步，无需重启容器。
Q3：如何实现 HTTPS/子域名访问？
A：推荐在主机部署 Nginx/Traefik 反向代理，为每位成员分配独立子域名并配置 SSL 证书。
Q4：如何扩展更多 AI 工具或自定义开发环境？
A：可直接修改 Dockerfile，添加所需依赖和工具，重建镜像即可。
Q5：多个容器使用主机网络模式时端口冲突怎么办？
A：项目已通过端口基数机制解决此问题。每个用户使用不同的端口基数（如10、20、30），容器会自动使用对应的端口范围，避免冲突。
Q6：如何使用 Python 环境？
A：容器使用系统级 Python 3.12，python 命令已指向 python3。预装了 pip、poetry 和 uv 包管理器，支持虚拟环境创建。
Q7：容器内服务如何被外部访问？
A：由于使用主机网络模式，容器内启动的任何服务都可以通过主机 IP 直接访问，无需额外的端口映射配置。
Q8：如何使用 AI 助手工具？
A：容器预装了多个AI助手和快捷别名：
yolo- Claude全自动执行模式（等价于claude --dangerously-skip-permissions）gyolo- Gemini全自动执行模式（等价于gemini --yolo）gemini- Google Gemini交互式AI助手，支持最多60次/分钟，1000次/天的免费请求
适用与不适用场景分析
- 最适合：小型技术团队、重视开发环境标准化、需要快速扩展的企业/创业公司。
- 不推荐：完全离线环境、对云端数据有极高敏感要求的场景。
监控与维护建议
- 定期监控容器 CPU/内存、磁盘使用、Claude API 状态。
- 建议每月更新镜像、工具和安全补丁。
- 支持日志审计，可通过
docker run --log-driver=syslog ...启用。
用户反馈与真实体验
"以前用 Claude Code断断续续，现在丝滑得很，重构大型组件再也不怕了。" —— 前端开发 "统一环境确实省心，新人入职直接给账号就能干活，不用再折腾各种配置。" —— 后端架构师 "团队开发效率明显提升，大家的代码质量也更一致了。" —— 项目经理
贡献与支持
- 欢迎 Star、Fork、提 Issue、提 PR！
- 如需定制化部署、AI 账号代开、企业级支持、垂直场景Manus开发，欢迎联系 ShareAI 团队
让 AI 赋能每一位开发者，让协作无国界。
如需更详细的技术原理、架构设计、实战经验和优化建议，欢迎查阅代码或 Issues 区交流、微信交流。
ai-lab@foxmail.com
