企业官网建设流程全解析

• 低代码
• 后端
• 前端
• 插件系统

Tego 是一个可插拔的 Node.js 低代码框架，本教程带你完成 Tego 部署：5 分钟本地跑起来，再用 Docker 一键上线生产环境，全程只需几条命令。无论你是第一次接触 Tego，还是准备把它部署到正式服务器，这篇 Tego 部署指南都能帮你少踩坑。

1. 部署前准备：环境要求与两种方式

🚀 Tego 提供两条部署路径，按你的场景选择：

环境要求：

• Node.js ≥ 20.19.0（见 package.json 中engines声明）
• 包管理器为pnpm（仓库通过preinstall脚本强制校验，仅允许 pnpm）
• Docker 部署方式则无需本地安装 Node，直接拉取官方镜像即可

官方推荐的三种生产可用产物：

1. 官方前端和插件集合tegojs/tego-standard
2. 官方 Docker 镜像tegojs/tego-all
3. 官方 npm 包tego

⚠️ 本仓库正处于核心重构阶段，生产环境请优先使用上述官方发布产物（见 README.zh-CN.md）。

2. 本地开发：3 步启动你的 Tego 应用

🔧 无需 clone 源码，一条命令即可创建应用：

# 第 1 步：创建一个新的 Tego 应用 npx tego init my-app # 第 2 步：进入项目目录 cd my-app # 第 3 步：启动应用（首次会自动执行安装） npx tego start --quickstart

启动后浏览器访问 http://localhost:3000，用默认账号登录：

• 用户名：tachybase
• 密码：!Admin123.

几个关键点：

• --quickstart参数会自动判断：未安装则执行安装，已安装则执行升级，然后重启应用，逻辑见 start.ts
• 默认数据库是SQLite，数据文件位于storage/db/tego.sqlite（见 presets/settings.js），零配置即可体验
• 服务监听端口由环境变量APP_PORT控制，默认3000，实现见 gateway.ts

3. 核心配置速查：环境变量清单

📋 Tego 的部署配置集中在 presets/settings.js。规则很简单：设置了环境变量就用环境变量，没设置就用这里的默认值。

数据库切换：默认 SQLite，生产环境建议 MySQL 或 PostgreSQL。通过.env文件修改database段配置（dialect、host、port、database、user、password），解析逻辑见 helpers.ts。请求体大小限制由APP_REQUEST_BODY_LIMIT控制，格式必须为数字 + 单位（如10mb），校验见 config.ts。

日志：默认输出到控制台和storage/logs目录（按天滚动），级别与格式同样可在 settings 中调整。

4. Docker 部署：生产环境一键上线

🐳 生产环境直接使用官方镜像tegojs/tego-all，无需构建：

# 拉取并启动 Tego docker run -d \ --name tego \ -p 3000:3000 \ -e APP_ENV=production \ -e APP_KEY=请替换为你的强随机密钥 \ -v /opt/tego/storage:/app/storage \ tegojs/tego-all

命令解读：

• -p 3000:3000：映射服务端口
• -e APP_KEY=...：⚠️ 必须更换为随机强密钥，它同时用于 JWT 令牌签名（见 jwt-service.ts），沿用默认值等于给应用开了后门
• -v /opt/tego/storage:/app/storage：数据卷挂载是生产部署的关键——SQLite 数据库、上传文件、插件、日志都存放在storage/下，挂载到宿主机才能在容器重建后保留数据
• 使用 MySQL/PostgreSQL 时，追加-e注入database相关环境变量即可

5. Nginx 反代与版本升级

🌐反代配置：若要通过 Nginx 暴露域名，框架内置了现成的 nginx 模板 tachybase.conf.tpl，其中已处理好三类路由转发：

• {{publicPath}}api/→ 后端 API（含 WebSocket 升级头，超时 600s）
• {{publicPath}}ws→ WebSocket 通道
• {{publicPath}}static/plugins/→ 插件静态资源

开发工具中执行create-nginx-conf命令即可基于模板生成实际配置（见 create-nginx-conf.ts），按需修改server_name与端口即可。

版本升级：应用启动时若检测到升级标记，会自动执行升级流程（start.ts）。手动升级也可执行npx tego sync同步最新包后重启。

6. 生产上线检查清单

✅ 上线前逐项确认：

1. APP_ENV=production
2. APP_KEY已更换为随机强密钥
3. 初始管理员账号tachybase / !Admin123.登录后立即修改
4. 数据库已从 SQLite 切换为 MySQL/PostgreSQL，且备份策略就绪
5. storage/目录已通过数据卷持久化
6. 日志落盘至storage/logs，按需调整级别
7. Nginx 反代模板已按实际域名调整

总结：Tego 部署的核心就三步——npx tego init创建、.env配置、Docker 或 Nginx 上线。本地 5 分钟体验，生产半天内可完成，把更多时间留给真正重要的业务搭建吧。

更多包结构与模块划分，可参考源码目录 packages/tego/ 与核心网关实现 gateway.ts。

• 低代码
• 后端
• 前端
• 插件系统