<think> 我们有两个引用，引用[1]是关于在Windows上配置one-api的docker-compose示例，引用[2]是关于使用docker-compose安装Ollama的示例。但用户现在需要的是使用Docker安装one-api的方法。 根据引用[1]中提供的docker-compose文件内容，我们可以提取出安装one-api的配置。同时，我们可以参考官方文档或其他可靠资源来完善步骤。 安装one-api的基本步骤： 1. 确保已经安装了Docker和Docker Compose。 2. 创建一个目录用于存放one-api的配置和数据。 3. 在该目录下创建docker-compose.yaml文件，内容参考引用[1]并做适当调整。 4. 运行docker-compose up启动服务。 由于引用[1]中的配置已经比较完整，我们可以直接使用它，并解释其中的关键部分。 另外，注意引用[1]中修改了端口映射，将宿主机的4000端口映射到容器的3000端口（因为one-api默认监听3000端口）。用户可以根据需要修改。 我们还可以提供一些额外的配置说明，比如如何配置环境变量（如令牌、数据库连接等）以及如何持久化数据。 步骤详解： 1. 创建项目目录并进入： ```bash mkdir one-api && cd one-api ``` 2. 创建docker-compose.yaml文件，内容如下： ```yaml version: '3.4' services: one-api: image: docker.io/justsong/one-api:latest container_name: one-api restart: always command: --log-dir /app/logs ports: - "4000:3000" # 左边是宿主机端口，右边是容器端口，可根据需要修改宿主机端口 volumes: - ./data:/data # 持久化存储数据，包括数据库和配置文件 - ./logs:/app/logs # 日志目录 ``` 注意：这里我们使用了`docker.io/justsong/one-api:latest`作为镜像，这是官方镜像。 3. 启动服务： ```bash docker-compose up -d ``` 4. 查看服务状态： ```bash docker-compose logs -f ``` 5. 访问one-api：在浏览器中访问`http://localhost:4000`（如果修改了宿主机端口，则使用修改后的端口）。 6. 初始管理员账号：默认用户名为`root`，密码为`123456`。登录后请立即修改密码。 补充说明： - 如果需要更改端口映射，修改docker-compose.yaml文件中`ports`部分即可。 - 数据持久化：通过volumes将容器内的`/data`目录映射到宿主机的`./data`目录，这样即使容器删除，数据也不会丢失。 - 日志：日志保存在宿主机的`./logs`目录下。 此外，one-api支持通过环境变量配置，比如设置`SQL_DSN`来使用外部数据库（默认使用内置的SQLite）。如果需要使用MySQL，可以添加环境变量配置，例如： ```yaml environment: SQL_DSN: "mysql://root:password@tcp(localhost:3306)/oneapi" ``` 但注意，如果使用外部数据库，需要确保数据库服务已经运行，并且已经创建了对应的数据库（例如`oneapi`）。 因此，完整的docker-compose文件（使用外部MySQL）可能如下： ```yaml version: '3.4' services: one-api: image: docker.io/justsong/one-api:latest container_name: one-api restart: always command: --log-dir /app/logs ports: - "4000:3000" volumes: - ./data:/data # 注意：如果使用外部数据库，这个卷可能就不需要了，因为数据库不在容器内。但配置文件等可能还会存在，所以保留。 - ./logs:/app/logs environment: SQL_DSN: "mysql://root:password@tcp(mysql:3306)/oneapi" # 假设使用同一个docker-compose中的mysql服务 depends_on: - mysql mysql: image: mysql:5.7 container_name: mysql environment: MYSQL_ROOT_PASSWORD: password MYSQL_DATABASE: oneapi volumes: - ./mysql-data:/var/lib/mysql ``` 不过，用户如果只是简单使用，内置SQLite已经足够。所以这里我们提供两种选择。 根据用户需求，我们先提供最简单的内置SQLite的安装方式。 注意：在docker-compose.yaml中，我们使用了`version: '3.4'`，但根据用户的环境，如果docker版本较低，可以降低版本号，比如`version: '3'`。 最后，我们提供一些常用的管理命令： - 停止服务：`docker-compose down` - 重启服务：`docker-compose restart` 现在，我们按照上述步骤编写回答。 </think> 以下是使用 Docker 安装 one-api 的详细教程，结合引用内容整理最佳实践： ### 📦 使用 Docker 安装 one-api 完整教程 #### 步骤 1：创建安装目录 ```bash mkdir one-api && cd one-api ``` #### 步骤 2：创建 `docker-compose.yaml` 文件 ```yaml version: '3.4' # 推荐使用 3.4 版本[^1] services: one-api: image: docker.io/justsong/one-api:latest # 官方镜像 container_name: one-api restart: always # 设置自动重启 ports: - "4000:3000" # 左边为宿主机端口，右边为容器端口[^1] volumes: - ./data:/data # 配置文件持久化 - ./logs:/app/logs # 日志持久化[^1] environment: - TZ=Asia/Shanghai # 时区设置 - SQL_DSN=sqlite:/data/oneapi.db # 默认使用SQLite ``` > 💡 关键参数说明： > - **端口映射**：`4000:3000` 表示通过宿主机 4000 端口访问 > - **数据持久化**：`./data:/data` 确保配置不丢失 > - **日志持久化**：`./logs:/app/logs` 保存运行日志 #### 步骤 3：启动服务 ```bash docker-compose up -d ``` #### 步骤 4：验证安装 ```bash # 查看运行状态 docker ps | grep one-api # 检查日志 docker logs one-api # 访问管理界面 http://localhost:4000/ # 默认账号 root/123456 ``` #### 步骤 5：配置数据库（可选） 如需使用 MySQL 替代 SQLite，添加环境变量： ```yaml environment: - SQL_DSN=mysql://root:password@mysql:3306/oneapi ``` 并添加 MySQL 服务： ```yaml services: mysql: image: mysql:8.0 environment: MYSQL_ROOT_PASSWORD: password MYSQL_DATABASE: oneapi volumes: - ./mysql-data:/var/lib/mysql ``` ### 🔍 常用管理命令 | 命令 | 说明 | |------|------| | `docker-compose stop` | 停止服务 | | `docker-compose restart` | 重启服务 | | `docker exec -it one-api sh` | 进入容器 | | `docker-compose down -v` | 删除容器和卷 | ### 💡 使用技巧 1. **修改端口**：编辑 `ports` 部分，如 `"5000:3000"` 2. **升级版本**：`docker-compose pull && docker-compose up -d` 3. **备份数据**：直接备份项目目录中的 `data` 文件夹 4. **接入模型**：在管理界面添加 Ollama 等模型服务（端口 11434）[^2] > ⚠️ 安全提醒：首次登录后立即修改默认密码，开启 HTTPS 访问