mogeko/alist Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

container-alist

一个distroless和rootless的容器，用于运行Alist文件管理服务器，旨在提供安全、轻量的部署方式。

核心功能和特性

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

使用场景

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

使用方法

基本部署

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

此容器专为Podman设计。对于Docker，建议使用xhofe/alist。

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。

作为distroless容器，容器内不含shell，无法通过usermod修改用户UID/GID。因此，需使用Podman的--userns选项将主机UID/GID映射到容器内用户的UID/GID。

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

有效的keep-id选项：

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

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

"Distroless"容器镜像

了解更多关于distroless容器镜像的信息。

许可证

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