需完成五步部署：一、创建阿里云ecs并初始化系统；二、全局安装qoder cli并绑定账号；三、配置mcp server及阿里云accesskey；四、通过git或scp同步本地项目；五、启动守护进程并开放3000端口。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已使用 Qoder 完成本地项目开发，希望将其稳定、安全、可协作地运行在远程服务器上，则需完成从本地环境到云服务器的完整部署配置。以下是构建私有开发基地的关键操作步骤：
一、准备阿里云 ECS 实例并初始化系统
该步骤旨在为 Qoder 远程运行提供干净、可控的 Linux 运行环境，确保后续 CLI 与 MCP Server 能稳定通信。系统初始化包括基础依赖安装与权限配置。
1、登录阿里云控制台，选择地域后创建一台按量付费的 ECS 实例，推荐配置：2 核 4 GB，操作系统选择 Ubuntu 22.04 或 CentOS 7.9。
2、实例启动后，在云服务器控制台中点击“远程连接”，使用 VNC 方式进入终端，或通过本地 SSH 工具连接（如 PuTTY 或 Terminal）。
3、执行系统更新与基础工具安装：
sudo apt update && sudo apt upgrade -y（Ubuntu）
或
sudo yum update -y（CentOS）
4、安装 Node.js 18.x（Qoder CLI 所需最低版本）：
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs
5、验证安装：
node -v 与 npm -v 应分别返回 v18.20.4 及对应 npm 版本号。
二、部署 Qoder CLI 并完成账号绑定
此步骤将 Qoder 的命令行能力部署至云服务器，使其具备自主执行代码生成、分析与部署任务的能力，并通过安全方式完成身份认证。
1、全局安装 Qoder CLI：
npm install -g @qoder-ai/qodercli
2、验证安装成功：
qodercli --version 应输出 0.2.7 或更高版本。
3、启动 CLI 并触发登录流程：
qodercli
4、在 CLI 界面中输入 /login，系统将生成一个临时授权链接。
5、在本地浏览器中打开该链接，使用已注册的 阿里云中国站账号 完成登录与授权，确认以组织开发者身份接入。
三、启用 MCP Server 并关联阿里云 AccessKey
MCP Server 是 Qoder 在云环境执行基础设施操作的核心代理，它需获得调用阿里云 API 的合法凭证才能创建资源、管理部署目标及同步文件。
1、登录阿里云控制台，进入“AccessKey 管理”页面，点击“创建 AccessKey”。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、记录生成的 AccessKey ID 与 AccessKey Secret，该密钥仅显示一次，请立即保存至安全位置。
3、返回 Qoder CLI 终端，输入 /mcp configure 启动 MCP 配置向导。
4、按提示依次输入 AccessKey ID、AccessKey Secret，并指定默认地域（如 cn-hangzhou）。
5、配置完成后，执行 /mcp test，若返回 "MCP connection successful" 即表示凭证生效。
四、将本地项目同步至云服务器
该步骤建立本地开发成果与云端运行环境之间的可信传输通道，支持 Git 推送或直接 SCP 上传两种互斥路径，确保代码完整性与可追溯性。
1、方式一（推荐 Git）：在云服务器上新建空目录，如 /home/ubuntu/my-dev-base，执行 git init；本地项目中添加该地址为远程 origin，执行 git push origin main。
2、方式二（SCP 直传）：在本地终端执行：
scp -r ./my-project user@your-ecs-public-ip:/home/ubuntu/
3、上传完成后，在云服务器中进入项目目录，执行 ls -la 确认 .qoderconfig、package.json 等关键文件存在。
4、若项目含前端构建产物，运行 npm install && npm run build（或对应构建命令），生成 dist/ 目录。
五、启动 Qoder 开发守护进程并暴露服务端口
此步骤使 Qoder 在后台持续监听指令，并将 Web 服务端口映射至公网，形成可被远程访问的私有开发界面，同时保障进程不随终端关闭而中断。
1、在项目根目录下执行：
qodercli --yolo --model=auto --port=3000
2、另开一个终端会话，执行 nohup qodercli --yolo --model=auto --port=3000 > /var/log/qoder.log 2>&1 &
3、检查进程是否存活：
ps aux | grep qodercli
4、在阿里云 ECS 安全组中，放行入方向 TCP 端口 3000，协议类型为 TCP，授权对象为 0.0.0.0/0（或限定 IP 段）。
5、等待约 15 秒后，在浏览器中访问 http://your-ecs-public-ip:3000，应加载出 Qoder Web 控制台登录页。
