Skip to main content
Square Cloud Sites 服务概览

​
为什么选择 Square Cloud？

每个站点都在 Cloudflare 全球网络之后提供服务，默认内置免费 TLS、免费 CDN 和 DDoS 防护：无论你部署的是静态落地页还是完整的框架 SSR 应用，都享有同样的生产级边缘。你只需配置一个子域名，证书、缓存和路由由我们负责。

Cloudflare 边缘 + Square Shield

每个站点都位于 Cloudflare WAF 之后，并在其上叠加 Square Shield，免费包含 DDoS 缓解、机器人过滤以及自动续期的 TLS。

NVMe + 10Gbps，隔离运行

企业级 NVMe SSD 与 10Gbps 上行链路，你的应用运行在隔离容器中。搭配免费的全球 CDN，静态资源会在边缘缓存并就近送达每一位访客。

托管式 DNS

自带域名，证书由我们负责：绑定你已经拥有的域名（Standard 及以上），在你的 DNS 服务商处创建控制面板显示的 DNS 记录，记录生效后 Square Cloud 会立即签发并续期 TLS 证书。

即时 snapshot

一键还原点，无需额外付费。几秒内即可从出错的 deploy 中恢复，无数据丢失、零停机。

​
支持的环境

使用你已经熟悉的技术栈托管站点。请先阅读网站与 API 托管指南，然后在下方选择你的框架：每张卡片都会打开一份附带代码的分步指南。

​
框架

Angular

Astro

Gatsby

Next.js

Nuxt

Phoenix

Preact

Qwik

React

React Router (Remix)

Ruby on Rails

SolidJS

Vite

Vue

静态 HTML/CSS

​
API 与后端

Django

Express

FastAPI

Fastify

Flask

Laravel

NestJS

Spring Boot

没有在列表中？几乎任何其他框架或库也能运行：只要它能在 80 端口上启动一个 Web 服务器，就能在 Square Cloud 上运行。

​
语言

JavaScript

Bun

Deno

Python

Java

Rust

Elixir

PHP

Go

C#

Ruby

HTML/CSS

​
开发者生态

无论你在哪里工作，都能部署和管理你的站点：

​
如何托管我的网站？

添加配置文件

在项目根目录创建一个 squarecloud.app 文件。配置文件指南解释了每个字段。网站还需要：
  • **SUBDOMAIN：**你站点的地址。SUBDOMAIN=test 会在 test.squareweb.app 提供服务。
  • **MEMORY：**为站点预留的 RAM，至少 512 MB。
请在第一次上传之前设置 SUBDOMAIN。没有设置它就部署的应用，之后无法再变成网站：你需要把它作为新应用重新上传。

包含依赖文件

将依赖文件保留在项目中：Node.js 使用 package.json，Python 使用 requirements.txt 或 pyproject.toml。Square Cloud 会在服务器上安装其中列出的所有内容。不要列出内置模块，例如 Node.js 中的 fs 或 Python 中的 random，因为它们随语言自带。

将项目打包成 zip

将代码、配置文件和依赖文件压缩成一个 .zip。不要包含 node_modules、__pycache__、package-lock.json 之类的锁文件以及其他生成的文件：依赖会在服务器上安装，而且上传的文件越小，部署越快。CLI 和 VS Code 扩展会自动排除锁文件。需要固定版本？请在 squarecloud.ignore 文件中添加 !package-lock.json。

上传你的站点

你的应用必须监听 80 端口和主机 0.0.0.0。运行时镜像已经把 PORT 和 HOST 环境变量设置为这两个值，因此读取它们的服务器无需任何修改。访客通过 HTTPS 访问你的站点，证书由 Square Cloud 负责。
在上传页面发送 .zip。Square Cloud 会安装依赖，根据你的配置文件设置环境，然后让你的站点上线。
正在上传应用到 Square Cloud

​
遇到问题？

应用无法启动

解决部署失败或启动时崩溃的问题：端口已被占用、缺少模块、INVALID_DEPENDENCY 或内存不足。

所有故障排除指南

按错误代码或症状查找应用、机器人和数据库问题的解决方法。

​
常见问题

我们推荐 Standard 套餐，每月 R44.99起∗∗，提供4GB内存和4个vCPU，还可以使用自定义域名。较轻量的站点也可以在∗∗Hobby∗∗套餐（∗∗每月R44.99 起**，提供 4 GB 内存和 4 个 vCPU，还可以使用自定义域名。较轻量的站点也可以在 **Hobby** 套餐（**每月 R12.49 起）上运行：网站至少需要 512 MB 内存。完整对比请参见套餐与价格。
可以。每次 Web 部署都会附带一个 *.squareweb.app 子域名，作为你套餐的一部分，无需额外付费。只要在配置文件中设置 SUBDOMAIN 字段即可使用。
自定义域名从 Standard 套餐起可用。Square Cloud 不注册也不出售域名：该功能用于连接你已在注册商处拥有的域名，每个应用一个主机名（例如 example.com 或 www.example.com）。所需的 DNS 记录请参阅如何设置你自己的域名；如果域名无法访问，请参阅为什么域名还没有生效。要通过代码绑定域名，请使用设置自定义域名。