网站导航
> 技术文档 > n1 armbian docker compose 部署aipan & mysql

n1 armbian docker compose 部署aipan & mysql

网友: 技术文档 2025-07-26 20:55:52

apt update
apt install docker-compose-plugin -y
#安装docker compose

docker compose  version
Docker Compose version v2.38.2

sudo mkdir -p /sda1/data/mysql/conf.d

sudo chown -R 999:999 /sda1/data/mysql # MySQL 用户 UID 通常为 999

cat docker-compose.yml 
version: \'3.8\'

services:
  # MySQL 服务
  mysql:
    image: mysql:8.0
    container_name: mysql-server
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: 密码 # 请修改为强密码
      MYSQL_DATABASE: aipan_db
      MYSQL_USER: aipan_user
      MYSQL_PASSWORD: 密码
    volumes:
      - /sda1/data/mysql:/var/lib/mysql  # 数据持久化
      - /sda1/data/mysql/conf.d:/etc/mysql/conf.d  # 配置文件挂载
    ports:
      - \"3306:3306\"
    networks:
      - app-network

  # aipan-netdisk-search 服务
  aipan:
    image: unilei/aipan-netdisk-search:latest
    container_name: aipan-netdisk-search-app
    restart: always
    depends_on:
      - mysql
    environment:
      # 配置数据库连接 URL，使用服务名 `mysql` 作为主机名
      DATABASE_URL: \"mysql://aipan_user:密码@mysql:3306/aipan_db?schema=public\"
    ports:
      - \"3000:3000\"
    networks:
      - app-network

networks:
  app-network:
    driver: bridge
 

docker compose up -d

 IP:3000访问

速度更快的版本

AIPan网盘搜索应用部署指南

本文档提供了AIPan网盘搜索应用的部署说明，包括系统要求、安装步骤和配置选项。

系统要求

  • Docker (20.10.0或更高版本)
  • Docker Compose (v2或更高版本)
  • 至少2GB RAM
  • 至少10GB可用磁盘空间
  • 互联网连接（用于拉取Docker镜像）

快速部署

1. 下载部署脚本

curl -O https://raw.githubusercontent.com/unilei/aipan.me/main/deploy.shchmod +x deploy.sh

2. 运行部署脚本

./deploy.sh

3. 选择部署选项

脚本将显示以下选项：

===== AIPan网盘搜索部署脚本 ===== 1) 完整部署 (首次部署或重新部署) 2) 更新配置 (仅修改配置并重启服务) 3) 运行数据库迁移 (初始化或更新数据库结构) 4) 重新生成 Prisma 客户端 (解决 Prisma 相关问题) 5) 退出

对于首次部署，选择选项1。

部署过程详解

完整部署

选择选项1后，脚本将执行以下操作：

  1. 检查Docker和Docker Compose是否已安装
  2. 创建配置文件（.env和docker-compose.yml）
  3. 生成随机管理员凭据（用户名、密码、JWT密钥）
  4. 拉取所需的Docker镜像
  5. 启动应用服务

部署完成后，应用将在以下地址可用：

  • Web应用：http://localhost:3000
  • WebSocket：ws://localhost:3002

重要提示：管理员凭据将保存在admin_credentials.txt文件中，请妥善保管此文件！

更新配置

如需修改配置，选择选项2。此选项允许您：

  1. 编辑.env文件
  2. 重启服务以应用新配置

运行数据库迁移

如需初始化或更新数据库结构，选择选项3。此选项将：

  1. 检查PostgreSQL容器是否运行
  2. 执行Prisma数据库迁移
  3. 运行数据库种子脚本

重新生成Prisma客户端

如遇到Prisma相关问题，选择选项4。此选项将：

  1. 重新生成Prisma客户端
  2. 可选择重启应用以应用更改

配置选项

端口配置

默认情况下，应用使用以下端口：

  • 应用端口：3000
  • WebSocket端口：3002

您可以在部署过程中自定义这些端口。

环境变量

主要环境变量说明：

变量名 说明 默认值 ADMIN_USER 管理员用户名 随机生成 ADMIN_PASSWORD 管理员密码 随机生成 ADMIN_EMAIL 管理员邮箱 随机生成 JWT_SECRET JWT密钥 随机生成 APP_PORT 应用端口 3000 WS_PORT WebSocket端口 3002 POSTGRES_USER PostgreSQL用户名 postgres POSTGRES_PASSWORD PostgreSQL密码 postgres POSTGRES_DB PostgreSQL数据库名 aipan

GitHub配置（可选）

如需启用GitHub集成，请在.env文件中设置以下变量：

NUXT_PUBLIC_GITHUB_OWNER=\"您的GitHub用户名或组织名\"NUXT_PUBLIC_GITHUB_REPO=\"您的GitHub仓库名\"NUXT_PUBLIC_GITHUB_TOKEN=\"您的GitHub个人访问令牌\"NUXT_PUBLIC_GITHUB_BRANCH=\"您的GitHub分支名\"

Quark配置（可选）

如需启用Quark集成，请在.env文件中设置以下变量：

NUXT_PUBLIC_QUARK_COOKIE=\"您的Quark Cookie\"

常见问题

端口冲突

如果默认端口已被占用，脚本将自动寻找可用端口。

数据库认证失败

如果遇到数据库认证失败的错误（如 Authentication failed against database server, the provided database credentials for \'aipan\' are not valid），可能是因为：

  1. 自定义数据库用户未正确创建或缺少权限
  2. 数据库连接字符串配置错误

解决方法：

  • 运行部署脚本选项 3（运行数据库迁移），这将自动修复用户权限
  • 或者手动执行以下命令创建用户并授权：
docker exec aipan-postgres psql -U postgres -c \"CREATE USER aipan WITH PASSWORD \'aipan123\';\"docker exec aipan-postgres psql -U postgres -c \"GRANT ALL PRIVILEGES ON DATABASE aipan TO aipan;\"

表权限错误

如果遇到表权限错误（如 permission denied for table ForumCategory），表示数据库用户没有足够的权限访问表。

解决方法：

  • 运行部署脚本选项 3（运行数据库迁移），这将自动更新表权限
  • 或者手动执行以下命令授予表权限：
docker exec aipan-postgres psql -U postgres -d aipan -c \"GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO aipan;\"docker exec aipan-postgres psql -U postgres -d aipan -c \"GRANT ALL PRIVILEGES ON ALL SEQUENCES IN SCHEMA public TO aipan;\"

数据持久化

应用数据存储在Docker卷中：

  • PostgreSQL数据：postgres-data
  • Redis数据：redis-data

查看日志

要查看应用日志，请运行：

docker-compose logs -f aipan-netdisk-search

停止服务

要停止所有服务，请运行：

docker-compose down

重启服务

要重启所有服务，请运行：

docker-compose restart

高级用法

手动编辑配置

您可以直接编辑.env文件来修改配置，然后重启服务：

nano .envdocker-compose restart

清理Docker资源

在部署过程中，您可以选择清理无用的Docker资源，包括：

  • 停止的容器
  • 未使用的网络
  • 未使用的数据卷
网络标签：

相关问题