Gitea 是轻量自托管 Git 代码托管系统对标 GitLab内存占用小支持代码仓库、Issue、PR、Wiki、CI Actions、团队权限管理适合内网军工 / 项目团队部署使用。Windows 本地搭建 Gitea两种方案Docker Desktop推荐简单、Windows 二进制直接运行不用 docker。 环境Win10/Win11。用途本地个人代码仓库、内网小组共享不建议直接裸暴露公网。方案 1Docker Desktop 方式推荐1 前置安装 Docker Desktop for Windows开启 WSL2 后端。启动 Docker Desktop。新建文件夹例如D:\gitea在里面新建docker-compose.ymlversion: 3.8 services: gitea: image: gitea/gitea:1.22 container_name: gitea restart: always environment: - USER_UID1000 - USER_GID1000 - GITEA__database__DB_TYPEpostgres - GITEA__database__HOSTdb:5432 - GITEA__database__NAMEgitea - GITEA__database__USERgitea - GITEA__database__PASSWDGiteaWin123 volumes: - ./data:/data ports: - 3000:3000 - 2222:22 depends_on: - db db: image: postgres:15-alpine container_name: gitea-pg restart: always environment: - POSTGRES_DBgitea - POSTGRES_USERgitea - POSTGRES_PASSWORDGiteaWin123 volumes: - ./pg_data:/var/lib/postgresql/dataPowerShell 进入D:\giteadocker compose up -d等待容器启动完成浏览器访问http://127.0.0.1:3000Web 初始化页面关键配置数据库PostgreSQL主机填db:5432账号密码和 yml 保持一致站点 URL本地用http://127.0.0.1:3000/如果局域网其他电脑要访问填本机局域网 IP例如http://192.168.1.100:3000/设置第一个管理员账号不要留空SSH 端口容器内部 22宿主机映射 2222ssh 克隆地址带端口git127.0.0.1:2222:xxx/xxx.git点安装 Gitea。局域网其他机器访问Windows 防火墙放行 3000、2222 端口。常用运维PowerShell# 停止 docker compose down # 查看日志 docker logs gitea # 重置管理员密码 docker exec -it gitea gitea admin change-password --username admin --password New123456 # 升级 docker compose pull docker compose up -d方案 2Windows 二进制包不装 Docker适合不想装 WSL/Docker 的场景。去 Gitea 官网下载 Windows 版本二进制gitea‑1.22.x‑windows‑amd64.exe新建目录D:\gitea_win把 exe 放进去。在这个目录打开 cmd/PowerShell执行gitea-1.22.x-windows-amd64.exe web第一次运行自动生成目录结构、custom/conf/app.ini。 浏览器打开http://127.0.0.1:3000进入安装页面。数据库选项本地玩可以选 SQLite多人使用建议本地装 PostgreSQL。做成 Windows 后台服务开机自启以管理员打开 PowerShell.\gitea-1.22.x-windows-amd64.exe install --service-name gitea之后在 Windows 服务里找到 gitea设置自动启动。停止服务sc stop gitea本地使用常见坑局域网别的电脑打不开页面Windows 防火墙阻止需要入站规则放行 3000/tcp、2222/tcp站点 URL 必须填写本机局域网 IP不能写 127.0.0.1。SSH 克隆带端口 2222git clone ssh://git192.168.1.100:2222/用户名/仓库名.git备份Docker 版直接备份 D:\gitea 整个文件夹数据库可导出docker exec gitea-pg pg_dump -U gitea gitea gitea_back.sql二进制版备份整个 gitea_win 目录。关闭注册登录管理员账号管理面板 - 站点管理关闭用户注册手动添加账号。最小测试版 composeSQLite不需要 postgres快速体验version: 3.8 services: gitea: image: gitea/gitea:1.22 container_name: gitea restart: always environment: - USER_UID1000 - USER_GID1000 - GITEA__database__DB_TYPEsqlite3 - GITEA__database__PATH/data/gitea.db volumes: - ./data:/data ports: - 3000:3000SQLite 只适合个人少量使用多人并发会卡顿。