使用 Docker Compose 部署 NocoDB：从零开始的完整指南

前言

NocoDB 是一款开源的低代码数据库工具，被广泛视为 Airtable 的开源替代品。它支持多种数据库（如 PostgreSQL、MySQL、SQLite 等），并提供了强大的可视化界面，方便用户快速搭建和管理数据库。本文将详细介绍如何使用 Docker Compose 部署 NocoDB，涵盖概念讲解、代码示例、应用场景和注意事项。

---

一、NocoDB 概念讲解

1.1 NocoDB 是什么？

NocoDB 是一款开源的低代码数据库工具，旨在通过可视化界面简化数据库的创建、管理和使用。它支持多种数据库引擎，并提供了类似电子表格的操作体验，适合开发者和非技术用户。

1.2 Docker Compose 的作用

Docker Compose 是一个工具，允许你通过 YAML 文件定义和管理多容器的 Docker 应用。在部署 NocoDB 时，Docker Compose 可以帮助我们快速启动 NocoDB 服务及其依赖的数据库服务。

---

二、部署 NocoDB 的步骤

2.1 环境准备

确保你的机器上已经安装了 Docker 和 Docker Compose。如果没有安装，可以参考以下命令安装 Docker Compose：

bash复制

sudo curl -L "https://github.com/docker/compose/releases/download/$(curl -s https://api.github.com/repos/docker/compose/releases/latest | grep tag_name | cut -d '"' -f 4)/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

2.2 创建项目目录

创建一个目录用于存放 NocoDB 的配置文件和数据：

bash复制

mkdir nocodb-project && cd nocodb-project

2.3 编写 docker-compose.yml 文件

根据你的需求选择合适的数据库引擎。NocoDB 支持多种数据库引擎，包括 PostgreSQL、MySQL 和 SQLite。以下是一个使用 MySQL 的 docker-compose.yml 文件示例：

yaml复制

version: '3.8'

services:
  nocodb:
    image: nocodb/nocodb:latest
    ports:
      - "8080:8080"
    environment:
      - NC_DB=mysql://nocodb:nocodb@db:3306/nocodb
      - NC_AUTH_JWT_SECRET=your-secret-key
    volumes:
      - ./data:/usr/app/data
    depends_on:
      - db

  db:
    image: mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=nocodb
      - MYSQL_USER=nocodb
      - MYSQL_PASSWORD=nocodb
      - MYSQL_DATABASE=nocodb
    volumes:
      - ./db-data:/var/lib/mysql

说明：

1. NC_DB 环境变量：用于指定 NocoDB 连接的数据库类型和连接信息。格式为 mysql://<username>:<password>@<host>:<port>/<database>。

2. MySQL 数据库配置：MYSQL_ROOT_PASSWORD 是 MySQL 的 root 用户密码，MYSQL_USER 和 MYSQL_PASSWORD 是普通用户的用户名和密码，MYSQL_DATABASE 是创建的数据库名称。

2.4 启动服务

在项目目录下运行以下命令启动 NocoDB 和 MySQL：

bash复制

docker-compose up -d

2.5 访问 NocoDB

打开浏览器，访问 http://localhost:8080，即可看到 NocoDB 的登录界面。

---

三、代码示例

除了 MySQL，你也可以选择其他数据库引擎。以下是一个使用 SQLite 的 docker-compose.yml 文件示例：

yaml复制

version: '3.8'

services:
  nocodb:
    image: nocodb/nocodb:latest
    ports:
      - "8080:8080"
    volumes:
      - ./data:/usr/app/data

---

四、应用场景

NocoDB 适用于以下场景：

1. 个人数据管理：用于整理个人笔记、任务清单等。

2. 团队协作：团队成员可以通过 NocoDB 共享和管理项目数据。

3. 快速开发：开发者可以利用 NocoDB 快速搭建数据库原型。

---

五、注意事项

1. 数据持久化：确保正确挂载数据卷，避免容器重启后数据丢失。

2. 环境变量：根据使用的数据库类型，正确配置 NC_DB 环境变量。

3. 端口冲突：确保主机端口未被占用。

4. 安全性：在生产环境中，建议使用 HTTPS 和更复杂的密钥。

---

六、总结

通过 Docker Compose 部署 NocoDB 是一种高效且便捷的方式。它不仅简化了安装过程，还提供了良好的可移植性和数据持久化支持。希望本文能帮助你快速上手 NocoDB，并在实际项目中发挥其强大的功能。

---

参考链接

• NocoDB 官方 Docker Compose 部署文档

• 群晖 NAS 部署 NocoDB - 飘零博客

• NocoDB 部署 Docker 的科普 - 51CTO 博客

• NocoBase Docker Compose 部署文档

• NocoDB 部署和安装