Skip to content

Commit 472e8bf

Browse files
authored
Update guides about ffmpeg docker image (#374)
* update ffmpeg image guide * fix typo in docker ffmpeg troubleshooting desc * add docker image building guide * fix "Use Docker" guide English version title level * move docker build guide block * fix tab name for docker image beta version
1 parent 2bc0174 commit 472e8bf

File tree

2 files changed

+61
-13
lines changed

2 files changed

+61
-13
lines changed

docs/guide/install/docker.md

+33-8
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ star: true
1818

1919
# Use Docker
2020

21-
See the log output for the admin's info:
21+
## See the admin's info:
2222

2323
#### Lower than v3.25.0
2424

@@ -37,7 +37,7 @@ docker exec -it alist ./alist admin random
3737
docker exec -it alist ./alist admin set NEW_PASSWORD
3838
```
3939

40-
### **Release version**
40+
## **Release version**
4141

4242
#### **docker-cli**
4343

@@ -109,11 +109,16 @@ services:
109109
### **Specify version**
110110
See https://hub.docker.com/r/xhofe/alist for details
111111

112-
### **Docker-ffmpeg**
112+
### **Image with built-in ffmpeg**
113113

114-
- https://github.com/alist-org/alist/pull/6054
114+
You can switch to image with out-of-the-box ffmpeg environment by adding `-ffmpeg` to any image tag.
115115

116-
I'm not sure if the method of **docker-compose** is correct. If it's not correct, you can give us feedback.
116+
If the thumbnail feature is still not working, please verify the following:
117+
118+
+ You are using local storage
119+
+ Switched to grid view
120+
+ The thumbnail switch in local storage driver settings is enabled
121+
+ The configuration path for the thumbnail cache folder in local storage is correct, for example, `data/thumbnail`
117122

118123
::: tabs#Docker-ffmpeg
119124

@@ -144,7 +149,7 @@ services:
144149
restart: unless-stopped
145150
```
146151

147-
@tab main
152+
@tab beta
148153

149154
**docker-cli**
150155

@@ -186,7 +191,27 @@ In this instance `PUID=1000` and `PGID=1000`, to find yours use `id user` as bel
186191
uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)
187192
```
188193

189-
### **Additional notes about the offline download feature**
194+
### **Manually build Docker image**
195+
196+
Install Docker, clone the repository, and navigate to the root directory of the repository, no additional preparation is needed.
197+
198+
::: tabs#Docker-build
199+
200+
@tab basic
201+
202+
```bash
203+
docker build -t xhofe/alist:latest .
204+
```
205+
206+
@tab with ffmpeg
207+
208+
```bash
209+
docker build -t xhofe/alist:latest-ffmpeg --build-arg INSTALL_FFMPEG=true .
210+
```
211+
212+
:::
213+
214+
## **Additional notes about the offline download feature**
190215

191216
If the image is not pulled using the '''docker pull --platform''' parameter, docker may pull the 32-bit image on the 64-bit operating system, which may cause the offline download function to be unavailable even under normal configuration.
192217

@@ -200,7 +225,7 @@ If the CPU architecture is 32-bit, there is currently no solution available.
200225

201226

202227

203-
### **How to update Docker installation?**
228+
## **How to update Docker installation?**
204229

205230
::: details docker-cli update
206231
1. docker ps -a #View the container (find the ID of the Alist container)

docs/zh/guide/install/docker.md

+28-5
Original file line numberDiff line numberDiff line change
@@ -117,13 +117,16 @@ services:
117117

118118
有关详细信息,请参阅 https://hub.docker.com/r/xhofe/alist
119119

120+
### **内置 ffmpeg 版镜像**
120121

122+
在任何镜像 tag 后添加 `-ffmpeg` 即可切换到带有开箱即用的 ffmpeg 环境版本镜像
121123

122-
### **Docker-ffmpeg**
124+
如果缩略图功能仍无法使用,请确认:
123125

124-
- https://github.com/alist-org/alist/pull/6054
125-
126-
**docker-compose** 的方式不确定是否正确,如果不正确可以反馈
126+
+ 使用的是本地存储
127+
+ 切换到网格视图
128+
+ 本地存储的缩略图开关开启
129+
+ 本地存储的缩略图缓存文件夹配置路径正确,例如 `data/thumbnail`
127130

128131
::: tabs#Docker-ffmpeg
129132

@@ -196,6 +199,26 @@ services:
196199
uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)
197200
```
198201

202+
### **手动编译 Docker 镜像**
203+
204+
安装 docker,克隆仓库后进入仓库根目录,无需其他准备
205+
206+
::: tabs#Docker-build
207+
208+
@tab basic
209+
210+
```bash
211+
docker build -t xhofe/alist:latest .
212+
```
213+
214+
@tab with ffmpeg
215+
216+
```bash
217+
docker build -t xhofe/alist:latest-ffmpeg --build-arg INSTALL_FFMPEG=true .
218+
```
219+
220+
:::
221+
199222
## **有关离线下载功能的额外说明**
200223

201224
若没有使用```docker pull --platform```参数拉取镜像时,docker可能会在64位操作系统上拉取32位镜像,这将可能导致离线下载功能即使在正常配置情况下也无法使用。
@@ -240,4 +263,4 @@ Q:我的版本是v3.x.x 怎么也升级不到最新版 `docker pull xhofe/alis
240263
A:原因是你的docker设置了镜像,从镜像更新不到最新版本,改一下/etc/docker/daemon.json,删除"registry-mirrors": ["镜像加速器地址"]
241264

242265
- 删除若不行,可以考虑更换一个`镜像加速地址`
243-
- 或者简单粗暴:下载时将`xhofe/alist:latest` 替换为`xhofe/alist:v3.16.3`(指定版本,写教程时最新的是3.16.3)
266+
- 或者简单粗暴:下载时将`xhofe/alist:latest` 替换为`xhofe/alist:v3.16.3`(指定版本,写教程时最新的是3.16.3)

0 commit comments

Comments
 (0)