Docker容器中的Netatalk

一个提供Apple Filing Protocol文件共享和mDNS服务发现的容器。

快速开始

要快速运行Netatalk容器，可先执行以下命令：

bash
docker run --detach --publish 548:548 kjake/netatalk:latest

重要提示：此命令不会在网络上宣告AFP服务；连接服务器需通过Finder的“前往 -> 连接服务器（CMD+K）”，然后输入afp://[docker_host]。

Netatalk的默认配置包含两个共享：名为“Share”的共享对应容器内的/media/share，名为“TimeMachine”的共享对应/media/timemachine挂载点。将主机目录挂载到这些路径是在网络上共享文件的最快方式：

bash
docker 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标志，可简单修改配置：

bash
docker 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目录，使其在重启后保持持久化，然后修改配置文件。但推荐优先使用上述主机挂载配置的方式。

设置访问凭证

要设置访问凭证，需提供下表中的环境变量：

示例

bash
docker 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服务。

致谢

• 感谢@rrva将此镜像更新至Netatalk 3.1.8版本并精简镜像，供大家使用。
• 感谢@cptactionhank最初创建此镜像。

贡献

此镜像的创建秉持最佳意图和对Docker的专业理解，但并非完美无缺。如果您有能力，恳请通过最佳实践和其他改进支持此仓库。

若发现文档过时、缺乏测试等问题，您可以通过以下方式提供帮助：

• 创建issue并开启讨论，或
• 提交包含修改的pull request

本项目的实现得益于Docker和GitHub提供的优质服务。