NocoDB容器化部署完整指南从本地 Compose 到 K8s 生产路径【免费下载链接】nocodb A Free Self-hostable Airtable Alternative项目地址: https://gitcode.com/GitHub_Trending/no/nocodb面向有基础 Docker/Linux 经验的开发者和运维人员本文覆盖单机 Compose、反向代理 HTTPS、K8s Helm 三条部署路径给出自托管数据库平台 NocoDB开源 Airtable 替代品的选型判断、关键配置与验证方式。先对号入座你的部署约束是哪种四条路径全部要求 PostgreSQL 存储元数据多副本场景另需 Redis。约束不同配置量差异很大先定位再动手场景关键约束推荐路径本地 / 演示体验无域名、无 HTTPS、单台机器Compose 最小栈8080 端口直出小团队内网内网域名、已有 Postgres/Redis 可复用Compose 对接外部数据库或用官方安装脚本公网单机生产必须 HTTPS、证书可自动续期Traefik 反向代理 外部托管数据库已有 K8s 集群多副本、自动扩缩、资源限额官方 Helm Chart 外部 PG/Redis场景一最小化 Compose 部署步骤本地 / 演示先克隆仓库直接用官方样例起步git clone https://gitcode.com/GitHub_Trending/no/nocodb cd nocodb/docker-compose/examples/quickstart-demo docker compose up -d该命令一键拉起 nocodb、worker、postgres、redis 四个服务。若要自行裁剪核心结构如下services: nocodb: image: nocodb/nocodb:latest # 生产请改为固定版本 tag environment: NC_DB: pg://db:5432?unocodbppwddnocodb NC_REDIS_URL: redis://redis:6379 NC_SITE_URL: http://服务器地址:8080 depends_on: # 等健康检查通过再启动避免首启连库失败 db: {condition: service_healthy} redis: {condition: service_healthy} volumes: [nocodb_data:/usr/app/data] ports: [8080:8080] db: image: postgres:17.10 environment: POSTGRES_USER: nocodb POSTGRES_PASSWORD: pwd POSTGRES_DB: nocodb volumes: [postgres_data:/var/lib/postgresql/data] healthcheck: test: [CMD-SHELL, pg_isready -U nocodb -d nocodb] redis: image: redis:7 volumes: [redis_data:/data] healthcheck: {test: [CMD, redis-cli, ping]} volumes: {nocodb_data: {}, postgres_data: {}, redis_data: {}}要点说明worker 与主服务同镜像、仅靠NC_WORKER_CONTAINERtrue区分职责负责后台任务自托管建议设NC_DISABLE_MUXtrue三个命名卷保证容器重建后附件与数据库不丢。含 worker 与健康检查的完整配置见 docker-compose.yml各样例的定位对比见 examples/README.md。验证方式curl -s http://localhost:8080/api/v1/health返回 200浏览器访问http://服务器地址:8080可注册首个管理员。场景二反向代理 HTTPS 核心配置公网 / 域名公网单机推荐 Traefik 自有证书。官方样例traefik-custom-ssl只对外暴露 80/443应用端口不出网核心片段nocodb: labels: - traefik.http.routers.nocodb.ruleHost(nocodb.example.com) - traefik.http.routers.nocodb.entrypointswebsecure - traefik.http.routers.nocodb.tlstrue traefik: command: - --providers.docker.exposedbydefaultfalse # 未打标签的服务一律不暴露 - --entryPoints.web.http.redirections.entryPoint.towebsecure # HTTP 强制跳 HTTPS - --entryPoints.web.http.redirections.entryPoint.schemehttps ports: [80:80, 443:443] volumes: - ./certs:/etc/traefik/certs:ro # 挂载自有域名证书这样配的原因有二其一exposedbydefaultfalse确保 compose 文件里的 db、redis 永远不会被误暴露到公网其二NocoDB 的邮件、Webhook、OAuth 回调链接都由NC_SITE_URL生成docker.env 中必须把它写成 HTTPS 公网地址否则邮件里链接不可达同时建议开启NC_SECURE_ATTACHMENTStrue让附件链接走代理。完整配置见 traefik-custom-ssl/docker-compose.yml内网域名或已有 Nginx 的团队可直接用官方 Auto_Upstall 安装脚本交互式向导会生成对应 compose 并支持指定已有 Postgres/Redis。验证方式curl -I http://nocodb.example.com返回 301 跳 https浏览器打开 https 地址出现登录页。场景三K8s Helm 安装与生产资源限制官方 Helm ChartChart.yaml不内置 Postgres/Redis要求外部实例天然符合生产集群计算与数据分离的约定。values 关键字段externalDatabase.host/database/username配existingSecret数据库连接串放 Secret不落明文replicaCount: 2externalRedisapp 与 worker 多副本队列依赖 Redisresources.requests默认每 Pod 请求 1 CPU / 2Gi官方建议最低 1Gi 内存扩缩容开autoscaling.enabled: truepersistence.size附件存储 PVC默认 10Gi不开启则用 emptyDirPod 重建附件即丢失ingress.hostsingress.tlsTLS 配合 cert-manager 注解nocodb.publicUrl留空时自动取自首个 Ingress hostexternalDatabase: host: pg.internal database: nocodb username: nocodb existingSecret: nocodb-db-secret # Secret 内放 DATABASE_URL externalRedis: host: redis.internal replicaCount: 2 resources: requests: {cpu: 1, memory: 2Gi} ingress: enabled: true hosts: [{host: nocodb.example.com, paths: [{path: /, pathType: Prefix}]}] persistence: enabled: true size: 10Gi该片段给出最小生产 values镜像 tag、副本探针等保持默认即可完整参数表见 charts/nocodb/values.yaml。请求链路如下安装命令helm install my-nocodb ./charts/nocodb -f my-values.yaml直接部署仓库内的 chart 目录并叠加自己的 values避免引入额外 chart 仓库依赖。验证方式kubectl get pods全部 Ready 后curl -sk https://nocodb.example.com/api/v1/health返回 200。部署前容易忽略的 4 件事⚠️容器重建后数据消失。元数据与附件存于/usr/app/data未挂卷时down即清空处理nocodb_data 命名卷必挂Postgres 单独用 pg_dump 纳入备份。升级行为不可控。docker compose pull up -d可能悄悄拉进破坏性新版原因镜像 tag 未固定处理锁定具体版本号换 tag 前先在预发验证。首启健康检查超时。启动后 worker 反复重启原因首次数据库迁移耗时就绪探测等不及处理Compose 给足start_period: 30sHelm 保留默认的 startupProbe勿收紧。NC_SITE_URL与访问地址不一致。邮件里的链接指向内网地址无法打开原因环境变量沿用本地默认值处理统一改为实际对外域名。版本固定与升级路径单机docker compose pull docker compose up -d即可滚动升级官方安装脚本生成的update.sh还附带镜像清理K8shelm upgrade my-nocodb ./charts/nocodb -f my-values.yamlchart 默认 RollingUpdatemaxUnavailable: 0保证迁移期间不下线实例。两条路径升级前都应先确认镜像 tag 与 chartappVersion。官方入口README.md部署问题可先查 charts/nocodb/README.md。—— 下期NocoDB 数据迁移与备份实战【免费下载链接】nocodb A Free Self-hostable Airtable Alternative项目地址: https://gitcode.com/GitHub_Trending/no/nocodb创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考