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

已废弃

此仓库不再更新。请将您的容器迁移至netatalk/netatalk。

兼容性警告

如果您之前使用Netatalk 3.1.18镜像在macOS中进行Time Machine备份，升级到Netatalk 3.2.0或更高版本镜像后可能会遇到错误。建议丢弃备份sparsebundle并重新进行备份。如果您必须访问旧的备份sparsebundle，降级到3.1.18镜像应该可以恢复访问。

关于Netatalk

Netatalk v3是一个高性能的开源文件服务器，通过TCP/IP实现Apple Filing Protocol (AFP) 3.4。它能够作为AppleShare文件服务器同时为多个macOS或Classic Mac OS客户端提供服务。

如何使用

以下是示例。请将默认用户名和密码替换为更安全的内容。

使用docker compose（Docker管理卷和Zeroconf）：

yaml
services:
  netatalk:
    image: netatalk/netatalk3:latest
    network_mode: "host"
    cap_add:
      - NET_ADMIN
    volumes:
      - afpshare:/mnt/afpshare
      - afpbackup:/mnt/afpbackup
      - /var/run/dbus:/var/run/dbus
    environment:
      - "AFP_USER=atalk"
      - "AFP_PASS=atalk"
volumes:
  afpshare:
  afpbackup:

使用docker run：

bash
docker run --rm --network host --cap-add=NET_ADMIN --volume "/path/to/share:/mnt/afpshare" --volume "/var/run/dbus:/var/run/dbus" --env AFP_USER=atalk --env AFP_PASS=atalk --name netatalk netatalk/netatalk3:latest

AppleTalk

Netatalk v3中缺少对AppleTalk网络栈的支持。如果您需要AppleTalk来连接Classic Mac OS或Apple II计算机，请升级到Netatalk 4.0。

容器配置

AFP使用TCP端口548，因此Netatalk容器配置为暴露此端口。

为简化起见，此镜像仅支持一个用户、一个共享卷和一个Time Machine卷。afpd日志被硬编码输出到容器的stdout，默认日志级别为info。

建议设置绑定挂载或Docker管理卷以实现持久化存储。否则，共享卷将存储在易失性存储中，容器关闭后数据将丢失。

服务发现

要使用Zeroconf服务发现，容器需要"host"网络驱动程序和NET_ADMIN权限。此外，我们依赖主机的D-Bus进行Zeroconf，通过绑定挂载/var/run/dbus:/var/run/dbus实现。

这些设置会降低Netatalk容器的隔离性，因此如果您优先考虑隔离和安全性，文件服务器在没有这些设置的情况下也能正常运行。但代价是每次从客户端连接AFP文件服务器时，您必须手动指定主机的IP地址。

环境变量

必填

这些变量用于设置文件服务器的身份验证凭据：

• AFP_USER
• AFP_PASS

可选

• AFP_GROUP - 拥有共享卷的组，AFP_USER会被分配到该组
• AFP_UID - 指定AFP_USER的用户ID
• AFP_GID - 指定AFP_GROUP的组ID
• SERVER_NAME - 向Zeroconf报告的服务器名称
• SHARE_NAME - 文件共享卷的名称
• AFP_LOGLEVEL - 日志详细程度；默认为"info"
• INSECURE_AUTH - 非零时，启用"Clear Text"和"Guest" UAMs
• MANUAL_CONFIG - 非零时，跳过Netatalk配置文件修改，允许手动管理配置

问题报告

如果您在Netatalk Docker镜像或Netatalk本身中发现错误，请在GitHub上提交issue。我们将尽快跟进您的报告。

另请参阅

• Netatalk主页
• GitHub项目主页
• Netatalk v3手册