/ docs / zh / docker.md
docker.md
 1  # Docker 部署指南
 2  
 3  ## 快速开始
 4  先准备好配置文件,设置服务器监听端口为`8888`、服务器监听地址为`0.0.0.0`
 5  
 6  ### docker run启动
 7  ```bash
 8  docker run -d \
 9    -p 8888:8888 \
10    -v /path/to/config.toml:/app/config/config.toml \
11    -v /path/to/tasks:/app/tasks \
12    asteria798/krillinai
13  ```
14  
15  ### docker-compose启动
16  ```yaml
17  version: '3'
18  services:
19    krillin:
20      image: asteria798/krillinai
21      ports:
22        - "8888:8888"
23      volumes:
24        - /path/to/config.toml:/app/config/config.toml # 配置文件
25        - /path/to/tasks:/app/tasks # 输出目录
26  ```
27  
28  ## 持久化模型
29  如果使用fasterwhisper模型, KrillinAI 会自动下载模型所需文件到`/app/models`目录和`/app/bin`目录。容器删除后,这些文件会丢失。如果需要持久化模型,可以将这两个目录映射到宿主机的目录。
30  
31  ### docker run启动
32  ```bash
33  docker run -d \
34    -p 8888:8888 \
35    -v /path/to/config.toml:/app/config/config.toml \
36    -v /path/to/tasks:/app/tasks \
37    -v /path/to/models:/app/models \
38    -v /path/to/bin:/app/bin \
39    asteria798/krillinai
40  ```
41  
42  ### docker-compose启动
43  ```yaml
44  version: '3'
45  services:
46    krillin:
47      image: asteria798/krillinai
48      ports:
49        - "8888:8888"
50      volumes:
51        - /path/to/config.toml:/app/config/config.toml      
52        - /path/to/tasks:/app/tasks
53        - /path/to/models:/app/models
54        - /path/to/bin:/app/bin
55  ```
56  
57  ## 注意事项
58  1. 如果docker容器的网络模式不为host,建议将配置文件服务器监听地址设置为`0.0.0.0`,否则可能无法访问服务。
59  2. 如果容器内需要访问宿主机的网络代理,请将代理地址配置项`proxy`的`127.0.0.1`设置为`host.docker.internal`,例如`http://host.docker.internal:7890`