Hostless 是一个容器平台,免费档不用绑卡就能跑真正的应用,不只是静态网页。这篇教程用一个待办清单应用做例子,从 Fork 代码开始,到在 Hostless 上部署上线,全程免费。
一、Hostless 免费档能做什么
Hostless 的免费档是一个全账号共享池:0.5 核 CPU、1GB 内存、512MB 存储,池子里的用量永不收费。免费档可以部署:
- 应用:用 Git 仓库加 Dockerfile 部署,什么语言都行,数量不限
- Worker:长期运行、不接收 HTTP 请求的后台进程
- 数据库:托管数据库,数量不限
- 静态站:上传 ZIP 就能上,不绑卡的话最多 5 个
构建免费,流量不限(合理使用,不包括视频流和大文件下载)。Hostless 宣称免费档不休眠、无冷启动。
有两个限制要先知道:第一,免费档没有 SSH,部署和管理都走控制台、Git 和 Dockerfile;第二,控制台里还有一个虚拟机入口,那是付费的,最小一档 1 核、512MB、10GB 盘是 4.5 美元一个月,不在免费档里。
本文用的示例应用是一个待办清单:Node.js 加 Express 写的前后端,页面上可以添加待办、打勾完成、删除、按全部、进行中、已完成筛选,数据保存在应用自带的磁盘里,刷新页面不会丢。
二、准备工作
- 一个 GitHub 账号,没有的话先去 https://github.com/ 注册一个
- 一个 Hostless 账号:打开 https://hostless.cloud/ ,点 Start for free,用邮箱和密码注册,再输入发到邮箱的 6 位验证码,全程不用绑卡
- 示例仓库:https://github.com/kjzxs/hostless-todo-demo
三、把示例仓库 Fork 到自己的 GitHub
打开示例仓库 https://github.com/kjzxs/hostless-todo-demo ,点右上角的 Fork,再点 Create fork,仓库就复制到你自己的 GitHub 账号下了。
Fork 之后看一下仓库里的文件,重点是这几个:
server.js:应用的后端,待办的增删改查接口都在这里public/:前端页面,index.html、style.css、app.jsDockerfile:告诉 Hostless 怎么构建镜像hostless.yaml:Hostless 的配置文件,构建方式、启动命令、健康检查都写在这里package.json:只有一个依赖 express
四、在 Hostless 上新建 App 并部署
- 打开 Hostless 控制台 https://hostless.cloud/ ,登录后在左侧点 Apps,再点新建应用。
- 连接 GitHub 账号,选中刚才 Fork 的仓库,分支选 main。
- 构建方式选 Docker,仓库里已经有
Dockerfile和hostless.yaml,构建命令和健康检查不用再改。 - 点部署,Hostless 会按顺序走完这几步:拉取代码、构建镜像、应用配置、健康检查、分配地址。
- 状态变成 Live 之后,点分配的地址,就能打开待办应用了。地址形如
https://你的应用名.hostless.site。
部署大概需要几分钟,第一次构建要下载基础镜像,会慢一点。构建日志可以在部署记录里看到,失败了先看日志再改。
五、打开应用,试一试
打开分配的地址,页面上已经有三条示例待办。试一下这几个功能:
- 在输入框写一件要做的事,点添加,或者按回车
- 点待办前面的方框打勾,文字会划掉;再点一次取消
- 点每条后面的叉号删除
- 点全部、进行中、已完成切换筛选
- 点清除已完成,一次删掉所有打勾的
刷新页面,数据还在,因为数据存在 data/todos.json,在应用自带的临时磁盘上。注意:重新部署后数据会重置,正式用的话请接 Hostless 的托管数据库。
六、改成你自己的应用
想改文字或者样式,直接改 public/ 里的文件:index.html 改页面结构,style.css 改样式,app.js 改交互。改完推到 GitHub,Hostless 会自动重新部署,不用再点一次。
想加功能的话,后端接口在 server.js 里:GET /api/todos 列出全部,POST /api/todos 新增,PATCH /api/todos/:id 修改,DELETE /api/todos/:id 删除,GET /health 是健康检查接口。
七、应用必须遵守的运行规则
Hostless 对应用有几条硬性要求,示例应用都已经遵守了,自己写应用时也要注意:
- 必须监听
PORT环境变量里的端口,不能写死端口号 - 必须绑定
0.0.0.0,只绑 localhost 外面访问不到 - 启动命令在
hostless.yaml的start_command里,这个示例是npm start - 健康检查接口要返回成功,这个示例是
GET /health,返回{"status": "ok"}
这几条的官方说明在 https://docs.hostless.cloud/app/overview ,配置文件格式在 https://docs.hostless.cloud/app/hostlessfile 。
八、常见问题
部署失败了怎么办
先打开部署记录看构建日志。最常见的是依赖装不上或者启动命令不对,照着日志里的报错改。
打开地址显示应用没起来
先看控制台里应用是不是 Live 状态,再看日志里有没有报错。多数情况是应用没有监听 PORT 环境变量,或者没有绑定 0.0.0.0。
免费池不够用了怎么办
免费档全账号只有一个共享池,应用、Worker、数据库都从这个池子里扣。hostless.yaml 里这个示例只跑 1 个副本,规格收在池子以内。如果开了多个应用,先把不用的停掉或者删掉,超池的部分才要绑卡按量计费,池内永远免费。
数据丢了
数据存在应用自带的临时磁盘上,重新部署会重置。这是演示用的做法,正式用的数据请接 Hostless 的托管数据库,见 https://docs.hostless.cloud/ 。
怎么绑自己的域名
在应用的设置里找到 Custom domains,按提示添加域名并做 DNS 验证,通过后自动配好 HTTPS。文档在 https://docs.hostless.cloud/app/customdomains 。
九、费用说明
免费档在共享池以内永不收费,也不用绑卡;只有用量超出池子才要绑卡按量计费。虚拟机不在免费档里,最小一档 4.5 美元一个月,产品页在 https://hostless.cloud/products/virtual-machines 。
评论区