Ubuntu 22.04部署Docker Registry 2.8.0+ds1遇500错误，咨询端口修改方法

你好，针对你遇到的Docker Registry 500内部错误和端口修改的需求，我来帮你梳理解决方案：

一、排查500内部服务器错误 #

500错误通常是Registry服务内部配置或权限异常导致的，你可以按以下步骤排查：

• 检查配置文件中的路径有效性：你的配置里tls.certificate、tls.key、auth.htpasswd.path都用了占位符path/my path，这些必须替换成绝对路径（比如/etc/docker/registry/certs/registry.crt），且路径对应的文件必须真实存在。如果路径错误或文件缺失，服务启动后会触发内部错误。
• 验证存储目录权限：Registry的默认存储目录/var/lib/docker-registry需要属于registry用户组，你可以执行以下命令检查并修正：

  ls -ld /var/lib/docker-registry
  # 如果所有者不是registry，执行
  chown -R registry:registry /var/lib/docker-registry
  

• 查看服务日志定位具体错误：这是最直接的排查方式，Ubuntu上Registry用systemd管理，执行以下命令查看实时日志：

  journalctl -u docker-registry.service -f
  

  日志里会明确给出错误原因，比如证书加载失败、存储目录无法写入、htpasswd文件格式错误等，根据提示修复即可。
• 确认htpasswd文件格式正确：确保你是用htpasswd工具生成的认证文件，比如：

  htpasswd -Bc /path/to/your/htpasswd username
  

  如果文件为空或格式不符合要求，会导致认证流程出错进而触发500错误。

二、修改Registry的监听端口 #

完全可以修改默认端口（不用局限于443/8443），只需要在配置文件的http块中调整即可，有两种方式：

1. 在addr字段直接指定端口：
   修改addr为你的IP:自定义端口，比如：

   http:
     tls:
        certificate: /绝对路径/证书文件.crt
        key: /绝对路径/密钥文件.key
     addr: 192.168.1.100:5000
     headers:
        X-Content-Type-Options: [nosniff]
   

2. 新增port字段单独指定：
   如果addr只写IP，可以单独加port字段：

   http:
     tls:
        certificate: /绝对路径/证书文件.crt
        key: /绝对路径/密钥文件.key
     addr: 192.168.1.100
     port: 5000
     headers:
        X-Content-Type-Options: [nosniff]
   

修改完成后，重启Registry服务使配置生效：

systemctl restart docker-registry.service

之后就可以通过https://你的IP:自定义端口/v2/_catalog访问Registry了，注意访问时必须带上指定的端口号。

备注：内容来源于stack exchange，提问作者ciro