{"slug":"render-engine","title":"render-engine","summary":"从零引导用户注册 Render.com 免费账号、Fork/Clone 代码仓库、配置环境变量、部署 Docker 容器到连接 Web 终端 (ttyd+tmux) 与 EasyTier 网格直连 SSH 的完整生命周期 SOP。用于用户提到从 0 部署 Render、注册 Render、render-engine、render-box、Render 容器部署、Render 终端连接、Render EasyTier 组网、Render 防休眠保活，或要在 Render 免费层上搭建持久安全 Linux 运行时时。包含从 0 引导注册、代码 Fork、Bl","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-10-21T17:29:03.727257Z","repo":{"url":"https://github.com/dengyie/awesome-skills","stars":78,"forks":18,"license":null,"updatedAt":"2026-11-04T14:21:47Z"},"bodyHtml":"<hr>\n<h2>name: render-engine\ndescription: 从零引导用户注册 Render.com 免费账号、Fork/Clone 代码仓库、配置环境变量、部署 Docker 容器到连接 Web 终端 (ttyd+tmux) 与 EasyTier 网格直连 SSH 的完整生命周期 SOP。用于用户提到从 0 部署 Render、注册 Render、render-engine、render-box、Render 容器部署、Render 终端连接、Render EasyTier 组网、Render 防休眠保活，或要在 Render 免费层上搭建持久安全 Linux 运行时时。包含从 0 引导注册、代码 Fork、Blueprint/手动配置、日志核验、多路连接与日常运维排错。</h2>\n<h1>Render-Engine 从零部署与连接管理 SOP (0 到 1 全周期指南)</h1>\n<p><code>render-engine</code> 是专为 Render.com Free Tier 打造的单容器安全 Linux Web-Box 运行环境。本 Skill 负责<strong>从零引导用户注册 Render 账号、获取代码仓库、配置环境变量、触发部署、核验日志，直到成功连接终端与虚拟网直连</strong>的完整生命周期。</p>\n<pre><code>┌────────────────────────────────────────────────────────────────────────────────────────┐\n│                                Render-Engine 全生命周期流程                             │\n└────────────────────────────────────────────────────────────────────────────────────────┘\n  阶段 0: 账号准备       阶段 1: 仓库获取       阶段 2: 服务配置       阶段 3: 触发构建       阶段 4: 终端连接\n┌─────────────────┐   ┌─────────────────┐   ┌─────────────────┐   ┌─────────────────┐   ┌─────────────────┐\n│ 注册 Render.com │──►│ Fork/Clone 仓库 │──►│ 配置环境变量    │──►│ 启动构建部署    │──►│ 登录 Web Shell  │\n│ (GitHub 快捷登录)│   │ (dengyie/       │   │ (密码/网格/探针)│   │ (核验 Build/    │   │ (ttyd+tmux/SSH) │\n│ 免费 512MB 实例 │   │  render-engine) │   │ (零配置开箱即用)│   │  Deploy 日志)   │   │ (持久化会话保持)│\n└─────────────────┘   └─────────────────┘   └─────────────────┘   └─────────────────┘   └─────────────────┘\n</code></pre>\n<p>按需查阅参考手册，避免一次性全量加载：</p>\n<ul>\n<li><code>references/deployment.md</code>：Render Blueprint（render.yaml）、环境变量配置矩阵与控制台图文引导</li>\n<li><code>references/network-mesh.md</code>：EasyTier smoltcp 用户态虚拟网格组网、Peer 连接与免密 SSH 直连</li>\n<li><code>references/terminal-persistence.md</code>：ttyd+tmux 断线无损保持机制与 Agent 自动化 WebSocket 协议</li>\n<li><code>references/troubleshooting.md</code>：常见排错（OverlayFS 宿主度量泄露辟谣、Spindown 保活与掉线恢复）</li>\n</ul>\n<hr>\n<h2>阶段 0：引导用户注册 Render.com 账号</h2>\n<p>接手从零部署任务时，先协助或引导用户准备平台账号：</p>\n<ol>\n<li><strong>注册入口</strong>：访问 <a href=\"https://dashboard.render.com/register\">Render 注册页面</a>。</li>\n<li><strong>推荐方式</strong>：选择 <strong>\"Sign up with GitHub\"</strong>。\n<ul>\n<li><strong>优势</strong>：一键授权登录，无需繁琐邮箱验证，且能直接打通后续 GitHub 仓库自动同步部署权限。</li>\n</ul>\n</li>\n<li><strong>配额说明（给用户的安心提示）</strong>：\n<ul>\n<li>Render 个人免费版（Free Tier）无需绑定信用卡即可部署 Docker Web Service。</li>\n<li>每个免费账号每月拥有 750 小时免费运行额度（足以全月 24 小时运行 1 个服务）。</li>\n<li>单实例配额：512 MB 内存、0.15 vCPU、单个公网端口。</li>\n</ul>\n</li>\n</ol>\n<hr>\n<h2>阶段 1：获取代码仓库 (Fork / Clone)</h2>\n<p>Render 通过拉取 Git 仓库代码自动执行 Docker 镜像构建。引导用户将项目同步到自己的 GitHub：</p>\n<ol>\n<li><strong>上游项目地址</strong>：<a href=\"https://github.com/dengyie/render-engine\"><code>https://github.com/dengyie/render-engine</code></a></li>\n<li><strong>操作指引</strong>：\n<ul>\n<li><strong>方式 A（Fork 到个人 GitHub，推荐用于长期自动化更新）</strong>：\n引导用户点击项目页面右上角 <strong>\"Fork\"</strong>，创建属于自己的副本（如 <code>https://github.com/&lt;user&gt;/render-engine</code>）。</li>\n<li><strong>方式 B（直接引用公开源仓库，适合一键体验）</strong>：\n若用户不想 Fork，Render 支持直接连接任何公开的 GitHub 仓库进行部署。</li>\n</ul>\n</li>\n</ol>\n<hr>\n<h2>阶段 2：在 Render 创建并配置服务</h2>\n<p>提供两种配置路径，优先推荐 <strong>路径 A（一键 Blueprint）</strong>：</p>\n<h3>路径 A：一键快速部署 (Render Blueprint，最快最准)</h3>\n<ol>\n<li>点击或引导用户在浏览器中打开专属部署入口：\n<pre><code>https://render.com/deploy?repo=https://github.com/dengyie/render-engine\n</code></pre>\n<em>(若用户已 Fork，将链接中的 repo 替换为用户个人仓库地址)</em></li>\n<li>页面会自动识别项目根目录下的 <code>render.yaml</code> 规格文件。</li>\n<li>提示用户核对或填入以下参数：\n<ul>\n<li><strong>Service Name</strong>：默认 <code>render-engine</code>（可自命名，例如 <code>my-box</code>）。</li>\n<li><strong>Region</strong>：选择就近机房（推荐 <code>Oregon (US West)</code>、<code>Singapore (Southeast Asia)</code> 或 <code>Frankfurt (EU Central)</code>）。</li>\n<li><strong>Plan</strong>：确认选中 <strong><code>Free</code></strong>。</li>\n</ul>\n</li>\n<li>点击 <strong>\"Apply\"</strong> 即可全自动创建服务。</li>\n</ol>\n<h3>路径 B：手动创建 Web Service</h3>\n<p>若通过控制台手动添加：</p>\n<ol>\n<li>登录 <a href=\"https://dashboard.render.com/\">Render Dashboard</a>，点击右上角 <strong>\"New +\"</strong> -&gt; 选择 <strong>\"Web Service\"</strong>。</li>\n<li>选择 <strong>\"Build and deploy from a Git repository\"</strong>，搜索并选中 <code>render-engine</code>。</li>\n<li>配置基本属性：\n<ul>\n<li><strong>Name</strong>：<code>render-engine</code></li>\n<li><strong>Region</strong>：推荐 <code>Oregon (US West)</code></li>\n<li><strong>Branch</strong>：<code>main</code></li>\n<li><strong>Runtime</strong>：选择 <strong><code>Docker</code></strong></li>\n<li><strong>Instance Type</strong>：选择 <strong><code>Free</code></strong> (512 MB / 0.15 CPU)</li>\n</ul>\n</li>\n<li>高级配置（Advanced）：\n<ul>\n<li><strong>Health Check Path</strong>：填入 <code>/health</code>（极其重要：平台借此判断容器启动完毕，杜绝 502）。</li>\n</ul>\n</li>\n<li><strong>环境变量按需注入（渐进式原则）</strong>：\n<ul>\n<li><strong>纯净开箱模式（零配置）</strong>：无需添加任何环境变量！容器会自动生成随机 18 位强密码并在日志打印。</li>\n<li><strong>固定凭据模式（推荐新手）</strong>：\n<ul>\n<li><code>SSH_PASS</code>：设置固定密码（如 <code>YourStrongPass2026!</code>，用于 Web 终端与 SSH）。</li>\n<li><code>TTYD_USER</code>：设置 Web 终端用户名（默认 <code>admin</code>）。</li>\n</ul>\n</li>\n<li><strong>虚拟网格模式（可选加入 EasyTier）</strong>：\n<ul>\n<li><code>ENABLE_EASYTIER</code>：<code>true</code></li>\n<li><code>ET_NAME</code>：网格名称（如 <code>my-mesh</code>）</li>\n<li><code>ET_SECRET</code>：通信密钥</li>\n<li><code>ET_PEERS</code>：核心节点（如 <code>tcp://hub1.example.com:11010</code>）</li>\n</ul>\n</li>\n<li><strong>监控探针模式（可选加入 Komari / MangoHub）</strong>：\n<ul>\n<li><code>KOMARI_ENDPOINT</code>：监控服务端地址（如 <code>https://hub.example.com</code>）</li>\n<li><code>KOMARI_TOKEN</code>：探针通信 Token</li>\n<li><code>KOMARI_FORCE_DISK_TOTAL</code>：<code>5368709120</code>（消除宿主机 OverlayFS 虚假度量泄露）</li>\n</ul>\n</li>\n</ul>\n</li>\n</ol>\n<hr>\n<h2>阶段 3：触发构建与部署日志核验</h2>\n<p>点击 <strong>\"Create Web Service\"</strong>，进入部署流程：</p>\n<ol>\n<li><strong>查看构建日志 (Build Logs)</strong>：\n<ul>\n<li>观察 Alpine 基础镜像拉取、Caddy/ttyd/EasyTier 二进制注入。</li>\n<li>确认无构建报错，直至输出 <code>=&gt; exporting to image</code>。</li>\n</ul>\n</li>\n<li><strong>查看运行日志 (Deploy / Service Logs)</strong>：\n<ul>\n<li>观察 <code>entrypoint.sh</code> 启动流程：\n<ul>\n<li><strong>提取随机密码</strong>（若未自定义 <code>SSH_PASS</code>）：\n<pre><code>========================================================\n  Root/Web password set to: XXXXXXXXXXXXXXXXXX\n========================================================\n</code></pre>\n<em>提醒用户妥善复制该 18 位密码！</em></li>\n<li>确认组件顺序拉起：<code>Caddy</code> (Port 10000)、<code>OpenSSH</code>、<code>ttyd</code>。</li>\n<li>确认探活放行：Render 平台发起 <code>/health</code> 探测并收到 <code>200 OK</code>，服务状态变更为绿色的 <strong>\"Live\"</strong>。</li>\n</ul>\n</li>\n</ul>\n</li>\n</ol>\n<hr>\n<h2>阶段 4：连接并使用 Render 容器</h2>\n<p>提供 3 种连接使用方式，适应不同场景：</p>\n<h3>方式 1：Web 浏览器直接访问 (零客户端门槛)</h3>\n<ol>\n<li>在 Render 控制台顶部获取已分配的 HTTPS 公网域名（如 <code>https://render-engine.onrender.com</code>）。</li>\n<li>在浏览器打开：\n<pre><code>https://&lt;your-service-name&gt;.onrender.com/shell/\n</code></pre>\n</li>\n<li>弹出 BasicAuth 认证弹窗：\n<ul>\n<li>用户名：<code>admin</code>（或自定义的 <code>TTYD_USER</code>）</li>\n<li>密码：日志打印的随机密码或自定义的 <code>SSH_PASS</code></li>\n</ul>\n</li>\n<li>成功登入内置持久化终端：\n<ul>\n<li>会话由 <code>tmux</code> 常驻守护（<code>main</code> 会话），断线、刷新或关掉浏览器，任务不中断；</li>\n<li>再次打开链接无缝恢复工作区（Attach）；</li>\n<li>支持鼠标滚轮滚动浏览历史（50,000 行缓冲区）。</li>\n</ul>\n</li>\n</ol>\n<h3>方式 2：通过 EasyTier 虚拟网格直连 SSH (安全无公网暴露)</h3>\n<p>若配置了 EasyTier，容器接入私有网格，IP 为 <code>10.144.144.90</code>：</p>\n<pre><code># 密码认证直接登录\nsshpass -p \"&lt;SSH_PASS&gt;\" ssh -o StrictHostKeyChecking=no root@10.144.144.90\n\n# 或通过网格跳板机 (如 pxed) 免密登录\nssh -o ProxyJump=pxed root@10.144.144.90\n</code></pre>\n<h3>方式 3：AI Agent 自动化无头连接 (WebSocket)</h3>\n<p>Agent 本地无浏览器时，可使用 Python 通过标准 WebSocket RFC 6455 发送二进制指令与捕获回显，详见 <code>references/terminal-persistence.md</code>。</p>\n<hr>\n<h2>阶段 5：日常运维、防休眠保活与常见排错</h2>\n<h3>1. 免费版 15 分钟休眠防断与 24/7 运行 (Keep-Alive)</h3>\n<ul>\n<li><strong>平台休眠机制</strong>：Render Free Tier 若连续 15 分钟无入站公网 HTTP 请求，容器将自动挂起进入 Spindown（下次请求需 15~30 秒冷启动重建 Pod，且会重置临时文件与 tmux 会话）。</li>\n<li><strong>额度核算</strong>：Render 每个免费账号每月分配 <strong>750 小时</strong> 运行时长。即使按全月 31 天无休持续跑满，<code>31 天 × 24h = 744h</code>，单实例 24/7 运行完全处于免费额度内，不会产生成本。</li>\n<li><strong>内置自主保活（默认开启）</strong>：<code>render-engine</code> 容器启动时会自动读取平台注入的 <code>RENDER_EXTERNAL_URL</code>，拉起轻量后台守护进程（<code>ENABLE_KEEPALIVE=true</code>，默认周期 300 秒），通过外部公网域名循环请求自身的 <code>/health</code>。此举可自动向 Render 边缘网关产生真实的入站 HTTP 流量，重置闲置计时器，开箱即用实现 24/7 常驻。</li>\n<li><strong>外部兜底拨测（可选备份）</strong>：为防止容器被手动重启后的冷启动滞后，亦可在外部 <a href=\"https://uptimerobot.com/\">UptimeRobot</a> 或各类定时服务（Cron / 自建 VPS Crontab）中配置辅助 HTTP 探活任务：\n<ul>\n<li>监控类型：<code>HTTP(s)</code></li>\n<li>URL：<code>https://&lt;your-service-name&gt;.onrender.com/health</code></li>\n<li>监控频率：每 <code>5 分钟</code> 或 <code>10 分钟</code> 一次</li>\n<li>预期响应：<code>200 OK</code>。</li>\n</ul>\n</li>\n</ul>\n<h3>2. 线上掉线诊断三步法</h3>\n<ol>\n<li>先查公网：<code>curl -s https://&lt;render-host&gt;/health</code>。若返回 200，定性为容器在线，仅为私有网格或监控断流。</li>\n<li>检查环境变量：核实 Render 控制台是否遗漏注入 <code>ET_PEERS</code> 或 <code>KOMARI_ENDPOINT</code>。</li>\n<li>临时热修复：在 Web Shell 执行 <code>easytier-cli connector add tcp://&lt;hub-ip&gt;:11010</code> 即可实时拉起虚拟网。</li>\n</ol>\n<h3>3. 辟谣“386G 磁盘占用 86%”告警</h3>\n<ul>\n<li><strong>真相</strong>：<code>df -h</code> 汇报的 386GB 盘已用 315GB 实为 Kubernetes 多租户节点的底层宿主 OverlayFS 泄露。</li>\n<li><strong>验证</strong>：在终端运行 <code>du -sh / --exclude=/proc --exclude=/sys --exclude=/dev</code> 确认实际占用仅约 <strong>191.7 MB</strong>。</li>\n<li><strong>处置</strong>：严禁误删系统文件；探针配置 <code>KOMARI_FORCE_DISK_TOTAL=5368709120</code> 即可归一化面板度量。</li>\n</ul>\n","files":[{"path":"references/deployment.md","sizeBytes":7102,"isText":true},{"path":"references/network-mesh.md","sizeBytes":2970,"isText":true},{"path":"references/terminal-persistence.md","sizeBytes":6908,"isText":true},{"path":"references/troubleshooting.md","sizeBytes":4280,"isText":true},{"path":"SKILL.md","sizeBytes":11925,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"notes-only","suspicious":0,"notes":1,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-10-21T17:29:28.49923Z","sha256":"BCFFBDBBB714C22A3FE77D3EA09E8EBAB161BA276C83C2E634AD913FA060536E","sizeBytes":18109},"review":null,"source":{"repositoryUrl":"https://github.com/dengyie/awesome-skills","path":"render-engine","license":null,"commit":"da7227dff3264bb0d82436c8f3fa3f493cb04149","subtreeSha":"B86A654D82A849294262BB4611D61B7B57A377EF63EF5095E2E76AAA10689948","lastSyncedAt":"2026-11-08T21:44:15.204655Z"},"reviewedAt":"2026-10-21T17:30:00.937132Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/dengyie/awesome-skills/tree/main/render-engine"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install dengyie-awesome-skills@llmmart"},{"target":"git","command":"git clone https://github.com/dengyie/awesome-skills.git"}]}