小微企业用 Gitea 自建内网代码与文档版本管理：Git 服务、Issues 跟踪与 Webhook 自动部署

摘要： Gitea 是轻量自托管 Git 服务，单容器即可运行，适合小微企业把代码、运维脚本、技术文档统一纳入版本管理，并用 Issues 跟踪需求、用 Webhook 触发自动部署，彻底告别散落在个人电脑上的"最终版_final2"。

一、为什么不继续用网盘和微信传文件

小团队常把程序、脚本、部署手册通过微信、U 盘、网盘传来传去，结果是"谁改了什么""最新版在哪"永远说不清。一次误覆盖就可能丢失半天工作。

Git 的提交历史、分支、差异对比天然解决协作混乱。相比 GitLab，Gitea 内存占用低一个数量级——一台 2G 内存的云主机就能稳定支撑十人团队，对预算有限的小微企业极其友好。

二、用 Docker Compose 快速部署

最小化部署只需一个服务，生产环境建议配 PostgreSQL 更易备份：

version: "3"
services:
  gitea:
    image: gitea/gitea:latest
    environment:
      - GITEA__database__DB_TYPE=sqlite3
      - GITEA__server__ROOT_URL=https://git.example.cn/
      - GITEA__server__SSH_PORT=222
    ports:
      - "3000:3000"
      - "222:22"
    volumes:
      - ./gitea-data:/data
    restart: always

启动后访问 http://服务器IP:3000/install 完成管理员初始化，设置站点名称、管理员账号。数据全部落在 ./gitea-data 卷，迁移整目录即可整体搬迁。

三、反向代理与 HTTPS

用 Nginx（或已有的 Nginx Proxy Manager）反代 3000 端口，绑定域名 git.example.cn 并配证书。这里有个极易踩的坑：ROOT_URL 必须写成外部访问地址（https://git.example.cn/），否则页面里的克隆链接、Webhook 回调会指向内网 IP，导致同事无法克隆、自动部署收不到推送。

SSH 克隆默认走 22 端口。若宿主机 22 已被占用，把容器 SSH 映射到 222（如上配置），克隆时用 ssh://git@git.example.cn:222/xxx/yyy.git。

四、把文档也纳入 Git

很多小微企业只把"代码"放版本库，却让运维脚本、API 文档、设备清单、部署手册散落在各处。其实这些全是文本，放进同一个 Gitea 仓库，走 PR 审阅后合并，谁在哪一行的改动都有迹可循。

Gitea 自带 Markdown 渲染和 Wiki 功能，等于顺手建了一份带版本历史的技术知识库。新人入职，克隆仓库就能看到完整的环境说明，不用再"口口相传"。

五、用 Issues 跟踪需求与故障

为每个项目建立 Issues：需求、Bug、待办分别打标签（priority、bug、doc）。可设里程碑（Milestone）对齐交付节点，例如"10月门店系统上线"。这比微信群里一句"帮我改个东西"更易追溯，也方便离职交接和复盘。

配合 Gitea 的看板视图，任务从"待办→进行中→已完成"一目了然，小团队无需再引入额外项目管理工具。

六、Webhook 触发自动部署

核心收益在自动化。在仓库 Settings → Webhooks 添加目标：当 push 到 main 分支，Gitea 向内部 CI 地址 POST 事件。接收端脚本逻辑很简单：

校验 X-Gitea-Signature（HMAC-SHA256），防止伪造请求；
git pull 拉取最新代码；
执行构建或 systemctl restart 服务名 完成热更新。

注意：Webhook 地址必须是从 Gitea 容器能访问到的内网或公网地址；若部署在另一台机器，确保网络互通并加 HMAC 校验。如此一来，开发人员 push 即上线，省去手工登录服务器的环节。

七、备份与权限

备份：定时打包 ./gitea-data 卷（含 git 仓库与数据库），异地存一份；PostgreSQL 场景用 pg_dump 导出更稳妥。
权限：用组织（Organization）把项目分组，成员按团队赋角色（Read/Write/Admin），员工离职即禁用账号，代码不随人走。
安全：启用 2FA，避免因弱密码导致源码泄露；公网暴露务必走 HTTPS。

小结

Gitea 让小微企业用极低成本获得"代码版本化 + 需求可追溯 + 部署可自动化"的研发基础设施。它不要求专职运维，却是信息化系统里投入最小、回报最稳的一环——今天花半小时部署，明天就告别"最终版_final2"。