纯后端版本部署

本指南帮助您安装和设置 ImageFlow。

前置条件

• Go 1.22 或更高版本
• Node.js 18 或更高版本（用于构建前端）
• WebP 工具（libwebp-tools）
• AVIF 工具（libavif-apps）
• Redis（可选，用于元数据和标签存储）
• Docker 和 Docker Compose（可选，用于容器化部署）

安装

您可以通过以下任一方法安装 ImageFlow：

方法一：直接安装

1. 克隆仓库

   git clone https://github.com/Yuri-NagaSaki/ImageFlow.git
   cd ImageFlow

2. 构建前端

   cd frontend
   bash build.sh
   cd ..

3. 构建后端

   go mod tidy
   go build -o imageflow

4. 配置环境变量

   复制示例环境文件并进行编辑：

   cp .env.example .env
   # 编辑 .env 文件进行配置

   详细配置请参见 配置指南。

5. 设置系统服务（以 systemd 为例）

   创建一个服务文件，例如 /etc/systemd/system/imageflow.service：

   [Unit]
   Description=ImageFlow Service
   After=network.target
    
   [Service]
   ExecStart=/path/to/your/imageflow/executable
   WorkingDirectory=/path/to/your/ImageFlow/directory
   Restart=always
   User=youruser # 替换为运行服务的用户
   EnvironmentFile=/path/to/your/ImageFlow/.env
    
   [Install]
   WantedBy=multi-user.target

   请相应地替换路径和 youruser。

6. 启用并启动服务

   sudo systemctl enable imageflow
   sudo systemctl start imageflow

方法二：Docker 部署

使用预构建镜像（推荐）

1. 克隆仓库

   git clone https://github.com/Yuri-NagaSaki/ImageFlow.git
   cd ImageFlow

2. 配置环境变量

   复制示例环境文件并进行编辑：

   cp .env.example .env
   # 编辑 .env 文件

   确保 Docker 可以访问此 .env 文件，或者直接在 docker-compose.yaml 中配置环境变量。

3. 启动服务

   docker compose up -d

本地构建部署

1. 克隆仓库

   git clone https://github.com/Yuri-NagaSaki/ImageFlow.git
   cd ImageFlow

2. 配置环境变量

   cp .env.example .env
   # 编辑 .env 文件

3. 构建并启动

   docker compose -f docker-compose-build.yml up --build -d

元数据迁移

如果您在之前使用基于文件的元数据存储后启用了 Redis，可以将元数据迁移到 Redis。

运行迁移工具：

# 默认执行
bash migrate.sh
 
# 强制迁移（即使之前已完成）
bash migrate.sh --force
 
# 指定自定义 .env 文件
bash migrate.sh --env /path/to/.env