如何将应用部署到 LingCode Cloud？

我们先说清楚"LingCode Cloud"托管究竟是什么，因为这个名字涵盖两件独立的事。本教程讲的是 Cloud 应用——托管前端：将 Web 应用构建后生成的 HTML、CSS 和 JavaScript，通过 LingCode 的边缘节点在真实 URL 上提供服务。这与托管后端（为每个项目提供含认证、存储和实时功能的 Postgres 数据库）是两回事，后者是独立功能，有专属教程。两者可以单独使用，也可以配合使用——在这里部署静态前端，（可选地）让它连接托管后端来处理数据。

之所以只需一键，是因为 IDE 已经掌握了所有必要信息：它知道你的项目文件夹，能运行构建命令，而且你已经登录了 LingCode 账户。因此它不需要你再去创建 Netlify/Vercel/AWS 账户并粘贴令牌——直接在本地构建，打包输出，然后上传到 LingCode 托管的服务器。整个过程中不涉及任何第三方凭证。

你将学到

• Cloud 按钮托管的是什么（静态前端），以及它有意不支持什么（服务端代码）
• 三个关键字段：应用名称、构建命令、输出目录
• 从点击 Deploy 到获得 URL，中间发生了什么
• 重新部署的工作方式，以及自定义域名和后端如何融入
• 限制条件，以及常见的"为什么部署失败"场景

核心概念：静态托管，一键搞定

LingCode Cloud 应用提供的是预构建的静态文件。不管你的项目编译成什么——一个单独的 index.html，还是 Vite/React/Svelte/Vue 构建后输出的 HTML 文件加 JS/CSS 块和静态资产——这些文件就是被托管的内容。服务器端不会运行你的代码；请求通过直接提供文件来响应，并带有单页应用回退（未知路径会返回 index.html，使客户端路由正常工作）。这个模型适合落地页、文档、仪表盘、游戏和 SPA。它不适合需要每次请求都运行 Node 的 Express/Next-SSR 服务器——对于那种情况，你要么把服务器部署到别处，要么给静态前端接一个托管后端来处理数据。

逐步部署

1. 在 Mac IDE 中登录你的 LingCode 账户。应用会发布到这个账户下；如果你未登录，Cloud 弹窗只会显示"登录 LingCode Cloud 以部署"以及一个 Open Account… 按钮。
2. 打开你想发布的项目文件夹，然后点击工具栏中的 Cloud 按钮（那个云中闪电图标——悬停提示为"Deploy this project to LingCode Cloud"）。弹窗标题为 Deploy to LingCode Cloud。
3. 为应用命名（必填），例如 Orbit Dodge。这只是一个便于识别的标签；公开 URL 仍然是一个 id。
4. 设置构建命令——对于框架项目，类似 npm install && npm run build。如果项目已经是纯静态文件（可以直接打开的 index.html），则留空。
5. 设置输出目录——构建写入静态文件的位置（Vite 对应 dist，Create React App 对应 build 等）。如果构建命令为空，这里就是包含 index.html 的文件夹（通常是项目根目录）。
6. 注意观察预检提示。这些提示是实时的、仅供参考：原生项目（含 .xcodeproj）会被标记为不兼容（"LingCode Cloud 托管静态 Web 应用"），Node 服务器/SSR 项目会提示只能托管其静态构建输出，而输出目录中缺少 index.html 则是阻塞性错误。在填写名称且无阻塞问题之前，Deploy 按钮保持禁用状态。
7. 点击 Deploy。你会看到进度依次经过 detecting → building → packaging → uploading（含上传百分比）。成功后，弹窗会显示你的实时 URL——https://lingcode.dev/apps/<id>/——以及 Copy 和 Open 按钮。

底层发生了什么

了解构建管道能让故障原因一目了然，而不是一头雾水：

• 构建——如果你提供了构建命令，IDE 会在项目文件夹中运行它（最长 10 分钟超时）并实时输出日志。非零退出码会在此中止，并显示日志末尾内容，因此有问题的构建永远不会被发布。
• 打包——检查输出目录根部是否有 index.html，然后将该目录的内容打包为 tar + gzip 压缩文件。
• 上传——压缩包发送到 LingCode Cloud，解压后每个文件都被存储并从边缘节点提供服务。新版本以原子方式切换，访客永远不会看到半部署状态的站点。

结果是一个带版本号的公开应用。由于托管基于文件，本地构建成功后所看到的内容就是线上的内容。

重新部署、域名与数据

重新部署：在同一项目上再次点击 Cloud 并点击 Deploy——它会更新同一个应用（相同 id、相同 URL），递增版本号，并保留已绑定的域名。无需"推广"操作；实时 URL 始终反映最新一次部署。

自定义域名：在部署弹窗中就有一个自定义域名区域。绑定 app.yourdomain.com（以及可选的 www 子域），将一条 DNS 记录指向 LingCode，HTTPS 会自动签发。完整说明——顶级域名 vs www、具体记录和 Cloudflare 代理注意事项——请参见为 Cloud 应用连接自定义域名。

数据：需要账户或存储功能的托管前端，可以连接托管后端——两者可以无缝配合使用。

值得了解的限制

• 每个应用 100 MB，每个文件 25 MB，最多 2,000 个文件——对于构建好的前端来说相当宽裕；如果超出，很可能是输出目录中包含了未优化的媒体文件或误入的 node_modules。
• 每个账户 25 个应用，每小时 12 次部署——正常迭代完全够用；速率限制只是防止失控的循环。
• 仅限静态内容——不执行服务端代码。如果应用需要服务端逻辑，请使用托管后端，而不是期望 Node 在这里运行。

下一步