【教程】CodeRed Cloud 免费套餐 SSH 登录方案：SFTP 上传 + Cloudflare Argo 隧道 + ttyd 网页终端

平台免费套餐禁用了 SSH shell，但可以曲线救国：SFTP 传代码 → 部署 Node.js 应用 → cloudflared Argo 出站隧道 + ttyd，把网页版终端挂到 Cloudflare 域名上，浏览器即开即用，全程不需要 root。

太长不看

SFTP 连接 ：`code.codered.cloud:22`，用户 `code`，密码去 Dashboard 重置（临时密码）

上传位置：`/www/`，共 5 个文件（`cr-run.sh` / `package.json` / `index.js` / `index.html` / `application.properties`）

平台不会自动 `npm install` ：必须在 `cr-run.sh` 里显式写

只有 3000 端口公网可达（Nginx 反代），其余端口被 Azure NSG 丢弃 → 用 cloudflared 出站隧道把 ttyd（`localhost:8001`）暴露出去

只有 `/www` 和 `/log` 可写，`$HOME`（`/home/code`）不可写；文件系统是临时的，重新 Deploy 会重建环境

0. 背景：为什么要这么折腾

CodeRed Cloud 是 Node.js / Django / WordPress 托管平台（轻量版 Heroku/Vercel），站点通过 SFTP 上传代码 + Dashboard 面板部署，支持 Node 22/24，预装 PM2。

免费套餐的硬限制：

思路很简单：SSH 被禁，那就自己造一个网页终端 —— Node 应用启动时下载 `ttyd`（Web Shell）和 `cloudflared`（Argo 隧道）两个二进制，ttyd 监听本地端口，cloudflared 建立出站隧道把它挂到 CF 域名，浏览器访问即获得一个可用的服务器 shell。

1. SFTP 登录

1.1 获取临时密码

1. 登录 CodeRed Dashboard：`https://code.codered.cloud`

2. 找到你的站点 → System Access (SFTP & SSH) 区块

3. 点 Reset System Password → 生成临时密码

^-^ 密码是临时的：每次 Deploy Production 重新部署后密码都会变，需要重新 Reset 一次。

1.2 连接参数

1.3 文件传输

传输工具和方式自行选择（FileZilla、WinSCP、命令行 `sftp` 等均可），具体操作步骤可咨询 AI 助手或查阅所用工具的文档，这里不再展开。核心就两点：

- 连接参数见上表：主机 `code.codered.cloud`、端口 22、用户 `code`、临时密码

- 所有文件都要传到 `/www/` 目录下

## 2. 上传什么：5 个文件，全部进 `/www/`

`cr-run.sh` 内容（关键）：

#!/bin/sh



npm install --production --no-audit --no-fund 2>&1



exec node index.js

^-^ CodeRed 不会自动 `npm install` 平台只执行 `cr-run.sh`，不装依赖。第一次部署报 `Cannot find module ‘express’` 就是漏了这一步。

`package.json`：

{



"name": "codered-ttyd",



"version": "1.0.0",



"description": "CodeRed Cloud web terminal via ttyd + Cloudflare Argo",



"main": "index.js",



"scripts": { "start": "node index.js" },



"dependencies": {



"axios": "latest",



"express": "latest"



  }



}

`application.properties` 关键配置项：

LITE_MODE=true



ENABLE_TTYD=true



# ttyd 登录凭证，格式: 端口:用户名:密码



ttyd-credential=8001:用户名:密码



# Argo 固定隧道凭证，注意http、端口8001



ttyd-argo-auth=

代码文件必须传到 `/www/` 根目录，平台入口 `cr-run.sh` 在那里，放别处不生效。

## 3. 部署：让代码跑起来

SFTP 传完文件后，去 Dashboard → Deployment 标签页：

^-^ CodeRed 不会自动重载代码，传完文件必须手动点 Deploy 或 Restart。

4. CF 转发 + ttyd：网页终端是怎么跑起来的

4.1 原理

用户浏览器 ──HTTPS──► Cloudflare Edge ──Argo 出站隧道──► cloudflared(容器内) ──► ttyd(localhost:8001)

为什么必须用 Argo 出站隧道：CodeRed 只有 3000 端口被 Nginx 反代到公网，其他端口在 Azure NSG 层直接丢弃 —— 入站连接根本进不来。而 cloudflared 建立的是出站 WebSocket 连接到 Cloudflare Edge，不碰 Azure 入站防火墙，所以完全不受限。

4.2 ttyd：网页终端本体

ttyd 是个 Web Shell 程序，浏览器打开即是终端。本项目由 `index.js` 在运行时从 GitHub Releases 下载二进制到 `/www/.npm/`（随机文件名防特征检测），`chmod 775` 后直接执行：

nohup /www/.npm/<随机名> -p 8001 -W -c '用户名:密码' bash >/www/.npm/<随机名>.log 2>&1 &

关键参数：

- `-p 8001`：监听端口（与隧道 Ingress 目标一致）

- `-W`：必须加，否则终端只能看不能输入

- `-c ‘user:pass’`：登录认证

4.3 访问

浏览器打开 `https://.cfargotunnel.com` → 输入 ttyd 用户名密码 → 就是一个完整的服务器 shell。

5. 注意事项（划重点）

1. ttyd 必须加 `-W`：否则网页终端只能看不能输。

2. 改代码流程：SFTP 上传 → Restart（小改）或 Deploy Production（改依赖），平台不会自动热重载。

本文为技术学习交流用途，请遵守所在地区法律法规及平台服务条款。有问题欢迎评论区交流。