企业官网建设流程全解析

本文阐述在局域网中通过IP和端口访问Gitea服务的完整配置步骤及其底层原理。

一、修改监听地址

步骤：

1. 编辑Gitea配置文件app.ini（路径：Linux常见/etc/gitea/app.ini或安装目录custom/conf/；Windows为安装目录下的custom\conf\）。
2. 定位[server]段，设置：

   [server] HTTP_ADDR = 0.0.0.0 HTTP_PORT = 3000

3. 保存文件，重启Gitea服务（Linux：systemctl restart gitea；Windows：服务管理器重启）。

底层原理：

• HTTP_ADDR指定Gitea HTTP服务绑定的IP地址。默认127.0.0.1仅监听本地回环接口，外部网络请求无法到达。
• 设置为0.0.0.0表示绑定本机所有可用网络接口（包括以太网、WiFi等），使得来自任何网卡IP的请求均可被接受。
• HTTP_PORT定义TCP监听端口（默认3000），服务在该端口上等待连接。

二、配置防火墙入站规则

步骤：

• Linux (firewalld)：

  sudofirewall-cmd --add-port=3000/tcp--permanentsudofirewall-cmd--reload

• Linux (ufw)：

  sudoufw allow3000/tcp

• Windows：在“高级安全 Windows Defender 防火墙”中创建新入站规则，类型为端口，指定TCP端口3000，允许连接。

底层原理：

• 操作系统防火墙默认过滤入站连接，只放行特定服务（如SSH、HTTP等）或已明确规则。
• 需显式添加允许规则，使外部设备能够向服务器的3000端口发起TCP三次握手。
• 规则作用于网络层/传输层，控制数据包是否被主机接收。

三、调整ROOT_URL参数

步骤：

1. 在app.ini的[server]段设置：

   [server] ROOT_URL = http://你的服务器局域网IP:3000/

   示例（服务器IP为192.168.1.100）：

   ROOT_URL = http://192.168.1.100:3000/

2. 保存文件并重启Gitea。

底层原理：

• ROOT_URL是Gitea生成绝对URL（如页面链接、重定向地址）时使用的基础前缀。
• 该参数不影响Gitea实际监听的IP和端口，但影响HTTP响应中的Location头部和页面中的超链接。
• 若ROOT_URL仍为localhost或127.0.0.1，则登录成功后的跳转地址、克隆URL等会指向localhost，导致外部设备无法正常使用这些功能。
• 设置为局域网IP后，所有生成的链接均指向该IP，确保外部访问的一致性。

四、验证访问

在同一局域网的其他设备上，使用浏览器访问：

http://服务器IP:3000

若能正常加载Gitea页面，则配置成功。

五、故障排查检查项

若访问失败，按顺序检查以下技术指标：

1. Gitea进程状态：确认服务是否正在运行（Linux：ps aux | grep gitea；Windows：任务管理器查看进程）。
2. 实际监听地址：执行netstat -tlnp | grep 3000（Linux）或netstat -ano | findstr 3000（Windows），确认输出为0.0.0.0:3000或*:3000，非127.0.0.1。
3. 网络连通性：客户端执行ping 服务器IP，确认ICMP可达。
4. 防火墙规则生效：临时关闭防火墙（Linux：systemctl stop firewalld；Windows：禁用公用防火墙）测试是否因防火墙导致，如是则重新检查规则配置。
5. Docker部署端口映射：若使用容器，执行docker ps检查是否映射了-p 3000:3000，确保宿主机端口正确转发至容器内部。