cptactionhank/netatalk

Netatalk Docker容器

镜像概述

该容器封装了Netatalk服务，提供Apple Filing Protocol（AFP）文件共享、Tracker搜索/Spotlight集成及mDNS服务发现功能，帮助用户实现苹果设备与其他设备的跨平台文件访问。

核心功能

1. 支持AFP协议的安全文件共享
2. 集成Tracker搜索，兼容Mac的Spotlight功能
3. 可选Avahi mDNS服务发现（需手动启用）
4. 默认提供Share（文件共享）和TimeMachine（备份）两个目录

使用场景

• 家庭网络中Mac、iPhone、iPad与其他设备的文件互传
• 为Mac设备搭建Time Machine备份服务器
• 小型办公环境中跨设备的文件协作访问

配置说明

快速启动

执行以下命令快速运行容器：

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

注意：未启用服务发现时，需通过Finder的前往→连接服务器（CMD+K）输入afp://[Docker主机IP]连接。

挂载主机目录到默认共享路径：

bash
docker run --detach \
    --volume [主机共享路径]:/media/share \
    --volume [主机备份路径]:/media/timemachine \
    --publish 548:548 \
    cptactionhank/netatalk:latest

自定义共享配置

Netatalk的配置文件为/etc/afp.conf，可通过两种方式修改：

挂载主机配置文件

bash
docker run --detach \
    --volume [主机afp.conf路径]:/etc/afp.conf \
    --volume [主机共享路径]:/media/share \
    --publish 548:548 \
    cptactionhank/netatalk:latest

容器内持久化配置

bash
docker run --detach \
    --volume /etc \
    --volume [主机共享路径]:/media/share \
    --publish 548:548 \
    cptactionhank/netatalk:latest

（推荐优先使用挂载主机配置文件的方式）

设置访问凭证

通过环境变量配置用户权限：

示例（使用当前主机用户信息）：

bash
docker run --detach \
    --volume /mnt/sda1/share:/media/share \
    --net "host" \
    --env AFP_USER=$(id -un) \
    --env AFP_PASSWORD=your_password \
    --env AFP_UID=$(id -u) \
    --env AFP_GID=$(id -g) \
    cptactionhank/netatalk:latest

启用服务发现

设置AVAHI=1并使用主机网络启用mDNS：

bash
docker run --detach \
    --net=host \
    --env AVAHI=1 \
    --volume [主机共享路径]:/media/share \
    cptactionhank/netatalk:latest

注意：--net=host存在安全风险，也可在主机部署独立mDNS服务器替代。

致谢

感谢@rrva对镜像的升级（Netatalk 3.1.8）及瘦身优化。

贡献

欢迎通过GitHub提交Issue或Pull Request改进镜像，包括文档更新、功能扩展等。