安装指南

TrailSnap 支持多种部署方式，推荐使用 Docker Compose 进行快速部署。

Docker 部署 (推荐)

使用 Docker Compose 可以一键启动所有服务，包括前端、后端、数据库和 AI 服务。

前置要求

安装 Docker 和 Docker Compose。
确保本地 5532, 8800, 8801, 8082 端口未被占用。

部署步骤

获取 docker-compose.yml

在项目根目录下创建一个 docker-compose.yml 文件，内容如下：

yaml

version: '3.8'

services:
  postgres:
    image: pgvector/pgvector:pg18-trixie
    container_name: postgres_container
    restart: always
    environment:
      POSTGRES_DB: trailsnap
      POSTGRES_USER: trailsnap
      POSTGRES_PASSWORD: trailsnap
      POSTGRES_INITDB_ARGS: "--encoding=UTF8 --lc-collate=C --lc-ctype=C"
      PGDATA: /var/lib/postgresql/data/pgdata
    networks: [ app-network ]
    ports:
      - "5532:5432"
    volumes:
      - ./pg_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U trailsnap -d trailsnap -p 5432"]
      interval: 5s
      timeout: 5s
      retries: 5
      start_period: 10s

  server:
    image: siyuan044/trailsnap-server:master
    restart: always
    expose: [ "8000" ]
    ports: [ "8800:8000" ]
    networks: [ app-network ]
    volumes:
      - ./data:/app/data
      - /path/to/your/photos:/app/Photos/  # 请修改为你的照片目录路径
    environment:
      - DB_URL=postgresql://trailsnap:trailsnap@postgres:5432/trailsnap
      - RAILWAY_DB_URL=postgresql://trailsnap:trailsnap@postgres:5432/railway
      - AI_API_URL=http://ai:8001
    depends_on:
      postgres:
        condition: service_healthy
        restart: true

  ai:
    image: siyuan044/trailsnap-ai:master
    restart: always
    expose: [ "8001" ]
    ports: [ "8801:8001" ]
    networks: [ app-network ]
    volumes:
      - ./data:/app/data
    
  frontend:
    image: siyuan044/trailsnap-frontend:master
    restart: always
    ports: [ "8082:80" ]
    depends_on: [ server ]
    networks: [ app-network ]

networks:
  app-network:
    driver: bridge

配置照片目录
修改 server 服务下的 volumes 配置，将 /path/to/your/photos 替换为你实际存放照片的本地目录路径。
Windows 用户示例：
yaml
```
- F:\Photos:/app/Photos/
```
Linux/macOS 用户示例：
yaml
```
- /home/user/photos:/app/Photos/
```
启动服务
在 docker-compose.yml 所在目录下执行：
bash
```
docker-compose up -d
```
访问应用
服务启动后，通过浏览器访问：
- 前端页面: http://localhost:8082
- 后端 API: http://localhost:8800/docs
- AI 服务文档: http://localhost:8801/docs

注意事项

数据持久化: 数据库数据会保存在当前目录下的 pg_data 文件夹中，应用数据保存在 data 文件夹中。请勿随意删除这些目录，以免丢失数据。
端口冲突: 如果默认端口被占用，请在 docker-compose.yml 中修改 ports 映射（例如 8083:80）。
照片权限: 确保 Docker 容器有权限读取挂载的照片目录。

源码部署

如果你希望参与开发或进行二次开发，可以选择源码部署。详细步骤请参考开发者指南 - 快速开始。

安装指南 ​

Docker 部署 (推荐) ​

前置要求 ​

部署步骤 ​

注意事项 ​