一键在生产服务器部署带数据库、缓存与网关的 NocoDB

方案简介

NocoDB 是一个在线快速构建数据库的开源平台。本方案基于官方 Auto-upstall 脚本，用一条命令在生产服务器上完成 NocoDB 的完整部署：脚本在后台自动生成 docker-compose 配置，一并安装 PostgreSQL 作为数据库、Redis 作为缓存、Traefik 作为网关，并自动配置与续期 SSL 证书。适合希望快速在自有服务器上搭建生产级 NocoDB 实例的用户。

亮点与能力

• 一条命令即可在生产服务器上部署 NocoDB
• 自动安装所有前置依赖，如 docker、docker-compose
• 使用 Docker Compose 自动安装 NocoDB + PostgreSQL + Redis + Traefik 网关
• 再次运行命令可自动升级到最新版本
• 自动配置 SSL 并自动续期（需提供域名或子域名）

组成与分工

• NocoDB：在线数据库构建平台，是本方案的核心应用
• PostgreSQL：作为 NocoDB 的持久化数据库（通过 NC_DB 连接串指定）
• Redis：随 Compose 一起安装的缓存组件
• Traefik：反向代理网关，负责入口流量与 SSL
• Docker / Docker Compose：容器化运行与编排，由脚本自动生成配置
• nocodb.sh 安装脚本：自动生成 compose 配置并完成上述全部安装

前置要求

• 一台服务器（生产用途），部署时需要提供域名或子域名用于 SSL
• docker、docker-compose 等前置依赖可由脚本自动安装，无需手动准备

实施步骤

1. 执行 Auto-upstall 脚本

在服务器上运行一条命令即可：

bash
bash <(curl -sSL http://install.nocodb.com/noco.sh) <(mktemp)

脚本会自动完成：安装 docker、docker-compose 等前置依赖；用 Docker Compose 安装 NocoDB + PostgreSQL + Redis + Traefik；安装过程中需要输入域名或子域名，用于自动配置 SSL。

2. 升级到最新版本

之后再次运行同一条命令，即可自动升级 NocoDB 到最新版本：

bash
bash <(curl -sSL http://install.nocodb.com/noco.sh) <(mktemp)

使用与配置要点

• 部署完成后通过 Traefik 网关以域名/子域名访问 NocoDB，SSL 由脚本自动配置并续期
• 若只是本地快速测试，可直接用 Docker + SQLite 方式运行，访问 http://localhost:8080/dashboard：

bash
docker run -d \
--name noco \
-v "$(pwd)"/nocodb:/usr/app/data/ \
-p 8080:8080 \
nocodb/nocodb:latest

• 需要外接 PostgreSQL 时通过环境变量 NC_DB 指定连接串：

bash
docker run -d \
--name noco \
-v "$(pwd)"/nocodb:/usr/app/data/ \
-p 8080:8080 \
-e NC_DB="pg://host.docker.internal:5432?u=root&p=password&d=d1" \
-e NC_AUTH_JWT_SECRET="569a1821-0a93-45e8-87ab-eb857f20a010" \
nocodb/nocodb:latest

注意事项与常见问题

• SSL 配置需要提供域名或子域名，没有域名无法启用该功能
• 官方提示：Binaries are only for quick testing locally.（二进制包仅用于本地快速测试），生产环境应使用 Auto-upstall 或 Docker 方式
• 安装脚本可在 GitHub 上查看：install.nocodb.com/noco.sh script can be found here in our github
• 更多安装方法参考官方文档 nocodb.com/docs/self-hosting

优缺点

• ✓ 一条命令完成生产部署
• ✓ 自动配置并续期 SSL
• ✕ 需提供域名或子域名

出处

本方案挖掘自开源项目 nocodb/nocodb，方案内容与实施命令均来自其 README 原文。