zh Deployment

← README · Wiki · English

简介 · 功能特性 · 技术栈 · 快速开始 · 部署 · 项目结构 · 系统架构 · 小部件 · API · 数据库 · 设置 · 安全 · 配置 · 路线 · License

部署

Cloudflare Workers

点击按钮连接 GitHub 仓库并部署到 Cloudflare Workers。平台会自动检测 npm run build 与 npm run deploy 作为构建与发布命令。

更新

新版本发布后，再次点击上方按钮，或在已 fork 的模板仓库中通过 Workers Builds 触发重新部署即可升级。

配置 D1 数据库时，选择已有的 ternssh 数据库，不要新建。这样会保留服务器、凭据、仪表盘等数据；npm run deploy 会自动执行数据库迁移。

若已在 Workers Builds 中配置过构建，通常只需推送新版本或手动触发一次构建，无需重复绑定数据库。

生产环境鉴权（Cloudflare Access / Basic Auth）见 安全说明 · 鉴权。

Docker（自托管）

Docker 镜像通过 Wrangler 本地模式运行完整应用，适合内网自托管或快速体验。官方镜像：ghcr.io/haradakashiwa/ternssh。

docker run（推荐预构建镜像）：

docker run -d \
  --name ternssh \
  -p 8787:8787 \
  -v ternssh-data:/app/.wrangler \
  --restart unless-stopped \
  ghcr.io/haradakashiwa/ternssh:latest

docker compose：

docker compose -f docker-compose.ghcr.yml up -d

指定版本：TERNSSH_TAG=1.0.0 docker compose -f docker-compose.ghcr.yml up -d

自定义端口：PORT=8080 docker compose -f docker-compose.ghcr.yml up -d

从源码构建：docker compose up -d --build

访问 http://localhost:8787（或你映射的端口）。数据持久化于卷 /app/.wrangler。

Basic Auth 与 onboarding 说明见 安全说明 · HTTP Basic Auth（数据库凭据）。