
kjake/netatalk一个提供Apple Filing Protocol文件共享和mDNS服务发现的容器。
要快速运行Netatalk容器,可先执行以下命令:
bashdocker run --detach --publish 548:548 kjake/netatalk:latest
重要提示:此命令不会在网络上宣告AFP服务;连接服务器需通过Finder的“前往 -> 连接服务器(CMD+K)”,然后输入afp://[docker_host]。
Netatalk的默认配置包含两个共享:名为“Share”的共享对应容器内的/media/share,名为“TimeMachine”的共享对应/media/timemachine挂载点。将主机目录挂载到这些路径是在网络上共享文件的最快方式:
bashdocker run --detach --volume [host_path]:/media/share --volume [host_path]:/media/timemachine --publish 548:548 kjake/netatalk:latest
详细配置部分假定您已具备Docker和Netatalk的管理知识。
配置Netatalk有两种方式:挂载配置文件或在容器内编辑文件。配置文件/etc/afp.conf的文档可参考此处。
通过创建容器时添加额外的Docker标志,可简单修改配置:
bashdocker run --detach --volume [host_path]:/etc/afp.conf --volume [host_path]:/media/share --volume [host_path]:/media/timemachine --publish 548:548 kjake/netatalk:latest
另一种自定义Netatalk配置的方式是通过--volume /etc挂载/etc目录,使其在重启后保持持久化,然后修改配置文件。但推荐优先使用上述主机挂载配置的方式。
要设置访问凭证,需提供下表中的环境变量:
| 变量名 | 描述 |
|---|---|
| AFP_USER | 在容器中创建用户并允许其访问/media/share |
| AFP_PASSWORD | 密码 |
| AFP_UID | 创建用户的UID |
| AFP_GID | 创建用户的GID |
bashdocker run --detach \ --volume /mnt/sda1/share:/media/share \ --net "host" \ --env AFP_USER=$(id -un) \ --env AFP_PASSWORD=secret \ --env AFP_UID=$(id -u) \ --env AFP_GID=$(id -g) \ kjake/netatalk:latest
此命令会将afp.conf中所有%USER%替换为AFP_USER的值:
ini[Global] log file = /var/log/netatalk.log [Share] path = /media/share valid users = %USER%
此镜像包含avahi守护进程,默认处于关闭状态。通过设置环境变量AVAHI=1启用,例如docker run -e AVAHI=1 ...。
服务发现仅在Avahi守护进程与用户处于同一网络时有效,因此创建容器时需使用--net=host标志,但请注意--net=host存在安全风险。或者,您也可以在主机上安装并配置mDNS服务器,以描述容器的AFP服务。
此镜像的创建秉持最佳意图和对Docker的专业理解,但并非完美无缺。如果您有能力,恳请通过最佳实践和其他改进支持此仓库。
若发现文档过时、缺乏测试等问题,您可以通过以下方式提供帮助:
本项目的实现得益于Docker和GitHub提供的优质服务。





探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
无需登录使用专属域名
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
VS Code Dev Containers 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
Harbor Proxy Repository 对接专属域名
Portainer Registries 加速拉取
Nexus3 Docker Proxy 内网缓存
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务