mogeko/alist

container-alist

一个distroless和rootless的容器，用于运行https://github.com/alist-org/alist%E6%96%87%E4%BB%B6%E7%AE%A1%E7%90%86%E6%9C%8D%E5%8A%A1%E5%99%A8%EF%BC%8C%E6%97%A8%E5%9C%A8%E6%8F%90%E4%BE%9B%E5%AE%89%E5%85%A8%E3%80%81%E8%BD%BB%E9%87%8F%E7%9A%84%E9%83%A8%E7%BD%B2%E6%96%B9%E5%BC%8F%E3%80%82

核心功能和特性

• Distroless容器：基于Google的distroless镜像构建，不含操作系统发行版组件，减少***面和镜像体积
• Rootless设计：以非root用户（UID/GID 65532）运行，降低安全风险
• 数据持久化：支持挂载主机目录保存Alist数据
• Podman优化：专为Podman设计，支持UID/GID映射，确保文件权限正确

使用场景

适用于需要安全、轻量部署Alist文件管理系统的场景，如个人文件共享、企业内部文档管理等。

使用方法

基本部署

使用以下命令启动Alist服务器：

此容器专为Podman设计。对于Docker，建议使用https://hub.docker.com/r/xhofe/alist%E3%80%82

sh
podman run -d \
    --name alist \
    --userns=keep-id:uid=65532,gid=65532 \
    -v /path/to/save/data:/opt/alist/data \
    -p 5244:5244 \
    ghcr.io/mogeko/alist:latest

设置管理员密码

启动容器后，设置管理员密码：

sh
# 随机生成密码
podman exec -it alist /usr/bin/alist admin random
# 手动设置密码（将NEW_PASSWORD替换为你的密码）
podman exec -it alist /usr/bin/alist admin set NEW_PASSWORD

访问Alist

访问 http://localhost:5244，使用管理员账号登录。

更多信息请参考Alist官方文档。

UID/GID映射

为确保安全性，容器以非root用户运行，其UID/GID为65532。

作为https://github.com/GoogleContainerTools/distroless%EF%BC%8C%E5%AE%B9%E5%99%A8%E5%86%85%E4%B8%8D%E5%90%ABshell%EF%BC%8C%E6%97%A0%E6%B3%95%E9%80%9A%E8%BF%87%60usermod%60%E4%BF%AE%E6%94%B9%E7%94%A8%E6%88%B7UID/GID%E3%80%82%E5%9B%A0%E6%AD%A4%EF%BC%8C%E9%9C%80%E4%BD%BF%E7%94%A8Podman%E7%9A%84%60--userns%60%E9%80%89%E9%A1%B9%E5%B0%86%E4%B8%BB%E6%9C%BAUID/GID%E6%98%A0%E5%B0%84%E5%88%B0%E5%AE%B9%E5%99%A8%E5%86%85%E7%94%A8%E6%88%B7%E7%9A%84UID/GID%E3%80%82

keep-id：创建用户命名空间，将当前用户的UID:GID映射到容器内相同的值。对于root创建的容器，当前映射会创建到新的用户命名空间。

有效的keep-id选项：

• uid=UID：覆盖容器内用于映射当前用户的UID
• gid=GID：覆盖容器内用于映射当前用户的GID

由于Docker（据了解）无法将主机UID/GID映射到容器内指定的用户UID/GID，因此推荐使用Podman运行此容器。

"Distroless"容器镜像

了解更多关于https://github.com/GoogleContainerTools/distroless%E7%9A%84%E4%BF%A1%E6%81%AF%E3%80%82

许可证

本项目代码以MIT许可证发布。