NocoDB 自部署完整指南5 分钟上线一个无代码数据库【免费下载链接】nocodb A Free Self-hostable Airtable Alternative项目地址: https://gitcode.com/GitHub_Trending/no/nocodbNocoDB 是一款可自部署的开源无代码数据库工具把 MySQL、PostgreSQL 或 SQLite 里的数据直接变成浏览器中的在线表格数据全程留在你自己的服务器上。它的定位是 Airtable 的自托管替代不买 SaaS、不写前端部署一次就得到一个带多种视图、支持协作编辑和对外分享的在线数据库。本文按「先跑起来 → 再接库 → 再玩视图」的顺序展开最后给环境变量速查和部署选型。 NocoDB Docker 部署一条命令跑起来结论先说最快路径只有一条docker run默认使用内置 SQLite不用先准备任何数据库。docker run -d --name noco -v $(pwd)/nocodb:/usr/app/data/ -p 8080:8080 nocodb/nocodb:latest这条命令启动 NocoDB 容器并映射 8080 端口到宿主机。启动后打开http://localhost:8080/dashboard第一个注册的账号即为管理员。两处提醒装之前先看一眼-v把宿主机当前目录下的nocodb/挂进容器/usr/app/data/NocoDB 的元数据和附件都存在这里。不挂载的话容器一重建数据全丢。8080只是宿主机侧的端口。被占用的话只改冒号前面比如-p 9090:8080然后用新端口访问。 连接已有数据源元数据切到 PostgreSQL / MySQL先分清两个概念Base 结构、字段定义、用户和权限属于元数据存在 NocoDB 自己的库里默认 SQLite 单文件你要可视化的业务数据才是后面接入的数据源。SQLite 零配置方便但不支持并发写入多人生产环境建议把元数据搬进 PostgreSQL 或 MySQL。两种方式方式一docker run加环境变量。用NC_DB传连接串pg://或mysql://开头docker run -d --name noco \ -v $(pwd)/nocodb:/usr/app/data/ \ -p 8080:8080 \ -e NC_DBpg://db-host:5432?urootpyour_passworddnocodb \ -e NC_AUTH_JWT_SECRET换成你自己的固定随机字符串 \ nocodb/nocodb:latestNC_AUTH_JWT_SECRET固定下来重启后登录态才不会失效。方式二直接用仓库自带的 compose。官方提供了含 PostgreSQL、Redis 的现成编排带健康检查和 worker 容器改一下数据库密码即可启动见 quickstart-demo 示例。️ 从空表到看板建表、加字段与视图切换在 dashboard 里新建一个项目再在项目下添加一张BaseNocoDB 管理的数据表单元可以理解为一张工作表命名「任务」。加字段。给表加四列「任务名」SingleLineText单行文本「状态」SingleSelect单选选项设为 待办 / 进行中 / 完成「负责人」User直接从工作区里选人「截止日期」Date字段类型还有 Number、Attachment、Rollup、Formula 等几十种完整清单可以看 smartsheet 组件目录。切视图。新建的 Base 默认是 Grid 网格视图。左上角加一个 Kanban 视图把「状态」设为分组维度行就变成各列里的卡片跨列拖动即改状态再建一个 Calendar 视图行会按「截止日期」自动排进日历。分享与表单。右上角 Share Base / View可选公开访问或带密码的私有访问。更常用的是建一个 Form 视图发链接没有账号的人也能在线填单却看不到整张表的其他内容。⚙️ NocoDB 环境变量配置速查日常使用不用碰任何配置。只有下表这四种情况才需要动对应变量什么时候变量怎么设元数据从 SQLite 换到 PostgreSQL / MySQLNC_DB连接串pg://或mysql://开头多人生产访问、多容器部署NC_AUTH_JWT_SECRET固定随机字符串不固定则重启后登录态失效要发邮件通知、生成对外分享链接NC_SITE_URL实例的公网访问地址多容器部署、实时同步NC_REDIS_URLredis://host:6379形式其余NC_开头的变量附件存储、遥测开关等都在 utils/envs.ts 统一读取按需查官方文档 self-hosting 章节即可。 NocoDB 部署选型SQLite 还是 PostgreSQL你的场景后端库部署形态个人测试、人数很少SQLite默认零配置单容器小团队正式使用PostgreSQLcomposeNocoDB PostgreSQL Redis已有 MySQL / PG 数据源直接连接不自带库单容器 NC_DB高并发、要跑导入导出 workerPostgreSQL Redisapp 与 worker 分离参考 deployment-worker.yaml一句话分界SQLite 是单文件存储方便但不支持并发写入——只要出现多人同时编辑就该切到 PostgreSQL。 NocoDB 常见问题排查症状容器重建后数据全没了 →原因没挂数据卷 →解决补上-v $(pwd)/nocodb:/usr/app/data/再重建容器。症状页面打不开8080 端口被占 →原因宿主机端口被其他服务占用 →解决映射改成-p 9090:8080用新端口访问。症状容器重启后每次都要重新登录 →原因NC_AUTH_JWT_SECRET没固定每次启动签名密钥都变 →解决设一个固定随机字符串并写进启动参数或 compose。症状外部网络打不开分享链接、收不到邮件 →原因NC_SITE_URL未配置系统生成不出对外 URL →解决设为实例的公网地址。 接下来可以做的三件事把手头一张 CSV 或 Excel 导入 Base替换掉原来传来传去的共享表格生成一个 API token 调一次 REST 端点SDK 在仓库的 packages/nocodb-sdk/把 Grid 切成 Kanban拖三条任务试试跨列改状态更多细节查官方文档的 self-hosting 与视图章节遇到问题可以去项目的 Discord 社区直接问。【免费下载链接】nocodb A Free Self-hostable Airtable Alternative项目地址: https://gitcode.com/GitHub_Trending/no/nocodb创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
