无法在Docker Swarm集群部署PyPiServer服务，请求配置排查

配置中的核心问题 #

• 本地路径挂载不匹配：你提到.htpasswd和packages在当前目录，但配置里用了绝对路径/home/sheguey/...。Swarm集群中，所有调度到的节点都需要存在该绝对路径，否则容器启动失败；如果是从当前目录部署，应该使用相对路径绑定，或者更稳妥的方式是使用命名卷管理持久化数据。
• Swarm模式下restart: always无效：restart指令在Swarm的deploy配置外不生效，必须将重启策略放在deploy.restart_policy中。
• 端口映射的风险：在Swarm中直接使用ports绑定主机端口，会在集群所有节点开放8081端口，容易引发端口冲突；既然已经配置了Traefik反向代理，建议移除ports映射，完全通过Traefik暴露服务。
• 命令参数冗余（可选优化）：/data/packages是pypiserver的默认工作目录，可简化命令参数。

修正后的pypi.yaml配置 #

version: '3.8'

services:
  pypi-server:
    image: pypiserver/pypiserver:latest
    networks:
      - traefik-public
    deploy:
      labels:
        - "traefik.enable=true"
        - "traefik.http.routers.pypi-server.rule=Host(`pypi.mydomaine.com`)"
        - "traefik.http.services.pypi-server.loadbalancer.server.port=8080"
        - "traefik.http.routers.pypi-server.entrypoints=websecure"
        - "traefik.http.routers.pypi-server.tls=true"
        - "traefik.http.routers.pypi-server.tls.certresolver=leresolver"
      # 替换restart: always为Swarm专属重启策略
      restart_policy:
        condition: on-failure
        delay: 5s
        max_attempts: 3
        window: 120s
    volumes:
      # 使用当前目录相对路径挂载，需确保部署命令在目标目录执行
      # 多节点集群建议启用下方命名卷配置，避免依赖节点本地路径
      - ./packages:/data/packages
      - ./.htpasswd:/data/auth/.htpasswd
    command: -P /data/auth/.htpasswd -a update,download,list

networks:
  traefik-public:
    external: true

# 可选：多节点集群推荐使用命名卷
# volumes:
#   pypi-auth:
#   pypi-packages:

部署注意事项 #

1. 命名卷优先：如果集群有多节点，建议启用配置中的命名卷，避免依赖节点本地文件路径。若使用命名卷，需先将.htpasswd复制到卷中，可通过临时容器完成：

   docker run --rm -v pypi-auth:/data/auth -v $(pwd)/.htpasswd:/tmp/.htpasswd busybox cp /tmp/.htpasswd /data/auth/.htpasswd
   

2. 权限检查：挂载的packages目录和.htpasswd文件需确保容器进程（默认UID/GID为1000）有读写权限，执行：

   chown -R 1000:1000 ./packages ./.htpasswd
   

3. Traefik验证：确认Traefik服务已加入traefik-public外部网络，且leresolver证书解析器配置正常。

内容的提问来源于stack exchange，提问作者cheikh gueye