如何配置Gitea实现自定义基础路径访问并解决资源加载错误

正确的server段配置 #

修改/etc/gitea/app.ini的[server]配置块为如下内容：

[server]
SSH_DOMAIN = example.com
DOMAIN = example.com
HTTP_PORT = 3000
ROOT_URL = http://example.com:3000/gitea/
HTTP_ADDR = /gitea
APP_DATA_PATH = /var/lib/gitea/data
DISABLE_SSH = false
SSH_PORT = 22
LFS_START_SERVER = true
LFS_JWT_SECRET = <secret>
OFFLINE_MODE = false
PROTOCOL = http

配置要点 #

• ROOT_URL：必须以斜杠结尾，确保静态资源路径生成正确，避免出现报错里域名缺失.com的低级错误。
• HTTP_ADDR：设置为与ROOT_URL一致的子路径/gitea，告知Gitea在该路径下监听处理请求。

操作步骤 #

1. 保存修改后的配置文件。
2. 重启Gitea服务：

systemctl restart gitea

3. 访问http://example.com:3000/gitea验证页面加载情况。

排查补充 #

如果问题仍存在：

• 检查git用户对/var/lib/gitea/public目录拥有读写权限，该目录存放Gitea所有静态资源文件。
• 再次核对ROOT_URL的域名、端口、子路径，确保与实际访问地址完全一致，无拼写错误。

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