如何修改docker-compose安装的搭配Postgres的Gitea的默认logo

前提准备 #

提前准备好适配尺寸的自定义Logo文件，推荐规格：

• 导航栏小logo：高度32-40px，透明背景的SVG/PNG格式
• 登录页大logo：高度120-180px，透明背景的SVG/PNG格式
• 浏览器标签页favicon：16x16/32x32px的ICO/PNG格式

操作步骤 #

• 第一步：修改docker-compose.yml配置，添加自定义资源挂载路径
  在Gitea服务的volumes节点下新增一行挂载配置，示例如下，其余原有配置保持不变：

services:
  gitea:
    image: gitea/gitea:latest
    volumes:
      - ./gitea/data:/data
      # 新增下面这行，将宿主机的自定义资源目录挂载到容器内对应位置
      - ./gitea/custom/public:/data/gitea/public

• 第二步：在宿主机创建对应目录，上传Logo文件
  在宿主机上创建./gitea/custom/public/img目录，将你准备好的自定义Logo重命名为和Gitea默认文件一致的名称，放到该目录下即可，对应文件名：
  • 导航栏小logo：logo.svg（新版本默认）/logo.png
  • 登录页大logo：logo-large.svg/logo-large.png
  • 浏览器favicon：favicon.ico/favicon.png
• 第三步：调整目录权限，避免容器读取报错
  执行命令修改目录权限，匹配容器内Gitea运行用户的UID：
  chown -R 1000:1000 ./gitea/custom
• 第四步：重启Gitea容器生效
  在docker-compose.yml所在目录执行命令重启服务：
  docker-compose up -d --force-recreate gitea
• 第五步：验证效果
  清空浏览器缓存后访问Gitea地址，即可看到替换后的自定义Logo。

常见问题排查 #

如果重启后Logo没有更新，优先检查：

• 文件名、文件存储路径是否和上述要求完全一致
• 宿主机自定义目录的权限是否配置正确
• 浏览器是否缓存了旧的Logo资源，可以用隐私模式访问验证

内容的提问来源于stack exchange，提问作者Thanh Huy Vu