{"id":39120688,"url":"https://github.com/quicklyon/gitea-docker","last_synced_at":"2026-01-17T20:33:22.909Z","repository":{"id":139444469,"uuid":"519474363","full_name":"quicklyon/gitea-docker","owner":"quicklyon","description":"Quickon Docker Image for Gitea","archived":false,"fork":false,"pushed_at":"2025-01-26T07:59:29.000Z","size":217,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-26T08:26:06.932Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Makefile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/quicklyon.png","metadata":{"files":{"readme":"README.md","changelog":"changelog/20220822.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2022-07-30T09:32:45.000Z","updated_at":"2025-01-26T07:59:08.000Z","dependencies_parsed_at":null,"dependency_job_id":"39a7a66a-b6a5-4e3a-a97e-553e7f738e8e","html_url":"https://github.com/quicklyon/gitea-docker","commit_stats":null,"previous_names":[],"tags_count":31,"template":false,"template_full_name":null,"purl":"pkg:github/quicklyon/gitea-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quicklyon%2Fgitea-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quicklyon%2Fgitea-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quicklyon%2Fgitea-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quicklyon%2Fgitea-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/quicklyon","download_url":"https://codeload.github.com/quicklyon/gitea-docker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quicklyon%2Fgitea-docker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28517684,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T18:55:29.170Z","status":"ssl_error","status_checked_at":"2026-01-17T18:55:03.375Z","response_time":85,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-17T20:33:22.195Z","updated_at":"2026-01-17T20:33:22.889Z","avatar_url":"https://github.com/quicklyon.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- 该文档是模板生成，手动修改的内容会被覆盖，详情参见：https://github.com/quicklyon/template-toolkit --\u003e\n# QuickOn Gitea 应用镜像\n\n[![GitHub Workflow Status](https://github.com/quicklyon/gitea-docker/actions/workflows/docker.yml/badge.svg)](https://github.com/quicklyon/gitea/actions/workflows/docker.yml)\n![Docker Pulls](https://img.shields.io/docker/pulls/easysoft/gitea?style=flat-square)\n![Docker Image Size](https://img.shields.io/docker/image-size/easysoft/gitea?style=flat-square)\n![GitHub tag](https://img.shields.io/github/v/tag/quicklyon/gitea-docker?style=flat-square)\n\n\u003e 申明: 该软件镜像是由QuickOn打包。在发行中提及的各自商标由各自的公司或个人所有，使用它们并不意味着任何从属关系。\n\n## 快速参考\n\n- 通过 [渠成软件百宝箱](https://www.qucheng.com/app-install/install-gitea-134.html) 一键安装 **Gitea**\n- [Dockerfile 源码](https://github.com/quicklyon/gitea-docker)\n- [Gitea 源码](https://github.com/go-gitea/gitea)\n- [Gitea 官网](https://gitea.io/)\n\n## 一、关于 Gitea\n\n\u003c!-- 这里写应用的【介绍信息】 --\u003e\nGitea 是一个自己托管的Git服务程序。他和GitHub, Bitbucket or Gitlab等比较类似。他是从 Gogs 发展而来，不过我们已经Fork并且命名为Gitea。对于我们Fork的原因可以看 [这里](https://blog.gitea.io/2016/12/welcome-to-gitea/)。\n\n![screenshots](https://raw.githubusercontent.com/quicklyon/gitea-docker/main/.template/screenshot.png)\n\nGitea官网：[https://gitea.io/](https://gitea.io/)\n\n\u003c!-- 这里写应用的【附加信息】 --\u003e\n### 目标\n\nGitea的首要目标是创建一个极易安装，运行非常快速，安装和使用体验良好的自建 Git 服务。我们采用Go作为后端语言，这使我们只要生成一个可执行程序即可。并且他还支持跨平台，支持 Linux, macOS 和 Windows 以及各种架构，除了x86，amd64，还包括 ARM 和 PowerPC。\n\n### 功能特性\n\n- 支持活动时间线\n- 支持 SSH 以及 HTTP/HTTPS 协议\n- 支持 SMTP、LDAP 和反向代理的用户认证\n- 支持反向代理子路径\n- 支持用户、组织和仓库管理系统\n- 支持添加和删除仓库协作者\n- 支持仓库和组织级别 Web 钩子（包括 Slack 集成）\n- 支持仓库 Git 钩子和部署密钥\n- 支持仓库工单（Issue）、合并请求（Pull Request）以及 Wiki\n- 支持迁移和镜像仓库以及它的 Wiki\n- 支持在线编辑仓库文件和 Wiki\n- 支持自定义源的 Gravatar 和 Federated Avatar\n- 支持邮件服务\n- 支持后台管理面板\n- 支持 MySQL、PostgreSQL、SQLite3、MSSQL 和 TiDB(MySQL) 数据库\n- 支持多语言本地化（21 种语言）\n- 支持软件包注册中心（Composer/Conan/Container/Generic/Helm/Maven/NPM/Nuget/PyPI/RubyGems）\n\n### 系统要求\n\n- 最低的系统硬件要求为一个廉价的树莓派\n- 如果用于团队项目，建议使用 2 核 CPU 及 1GB 内存\n\n### 浏览器支持\n\nChrome, Firefox, Safari, Edge\n\n## 二、支持的版本(Tag)\n\n由于版本比较多,这里只列出最新的5个版本,更详细的版本列表请参考:[可用版本列表](https://hub.docker.com/r/easysoft/gitea/tags/)\n\n\u003c!-- 这里是应用的【Tag】信息，通过命令维护，详情参考：https://github.com/quicklyon/template-toolkit --\u003e\n- [latest,1.23.1,1.23.1-20250126](https://github.com/go-gitea/gitea/releases/tag/v1.23.1)\n- [1.22.2,1.22.2-20241008](https://github.com/go-gitea/gitea/releases/tag/v1.22.2)\n- [1.21.11,1.21.11-20240419](https://github.com/go-gitea/gitea/releases/tag/v1.21.11)\n- [1.20.4,1.20.4-20230914](https://github.com/go-gitea/gitea/releases/tag/v1.20.4)\n- [1.19.4,1.19.4-20230706](https://github.com/go-gitea/gitea/releases/tag/v1.19.4)\n- [1.18.5-20230313](https://github.com/go-gitea/gitea/releases/tag/v1.18.5)\n- [1.17.4-20221223](https://github.com/go-gitea/gitea/releases/tag/v1.17.4)\n\n## 三、获取镜像\n\n推荐从 [Docker Hub Registry](https://hub.docker.com/r/easysoft/gitea) 拉取我们构建好的官方Docker镜像。\n\n```bash\ndocker pull easysoft/gitea:latest\n```\n\n如需使用指定的版本,可以拉取一个包含版本标签的镜像,在Docker Hub仓库中查看 [可用版本列表](https://hub.docker.com/r/easysoft/gitea/tags/)\n\n```bash\ndocker pull easysoft/gitea:[TAG]\n```\n\n## 四、持久化数据\n\n如果你删除容器，所有的数据都将被删除，下次运行镜像时会重新初始化数据。为了避免数据丢失，你应该为容器提供一个挂在卷，这样可以将数据进行持久化存储。\n\n为了数据持久化，你应该挂载持久化目录：\n\n- /data 持久化数据\n\n如果挂载的目录为空，首次启动会自动初始化相关文件\n\n```bash\n$ docker run -it \\\n    -v $PWD/data:/data \\\ndocker pull easysoft/gitea:latest\n```\n\n或者修改 docker-compose.yml 文件，添加持久化目录配置\n\n```bash\nservices:\n  Gitea:\n  ...\n    volumes:\n      - /path/to/persistence:/data\n  ...\n```\n\n## 五、环境变量\n\n\u003c!-- 这里写应用的【环境变量信息】 --\u003e\n| 变量名           | 默认值        | 说明                             |\n| ---------------- | ------------- | -------------------------------- |\n| EASYSOFT_DEBUG   | false         | 是否打开调试信息，默认关闭       |\n| APP_DOMAIN       | 0.0.0.0:8080  | Gitea域名,影响访问与仓库的地址 |\n| APP_PROTOCOL     | https         | Gitea域名协议 |\n| MYSQL_HOST       | 127.0.0.1     | MySQL 主机地址                   |\n| MYSQL_PORT       | 3306          | MySQL 端口                       |\n| MYSQL_DB         | gitea          | spug 数据库名称                 |\n| MYSQL_USER       | root          | MySQL 用户名                      |\n| MYSQL_PASSWORD   | pass4QuickOn  | MySQL 密码                        |\n| DEFAULT_ADMIN_USER| gitea        | 默认管理员名称             |\n| DEFAULT_ADMIN_PASSWORD | pass4Gitea | 默认管理员密码 |\n| GITEA_ADMIN_EMAIL | admin@demo.com | 管理员邮箱地址|\n| ENABLE_SWAGGER   | false         | 是否启动Swagger API页面|\n| ALLOWED_HOST_LIST | *         | 信任的 Webhook 域名列表 |\n| MAIL_ENABLED | false        | 是否启用邮箱功能 |\n| SMTP_HOST | mail.demo.com        | 邮箱地址 |\n| SMTP_PORT | 465        | 邮箱端口 |\n| SMTP_USER | gitea@demo.com        | 邮箱发送账号 |\n| SMTP_PASS | mail4Gitea        | 邮箱发送账号密码 |\n| SSH_LISTEN_PORT | 22        | 默认监听22 |\n| START_SSH_SERVER | false        | 默认不开启ssh |\n| DISABLE_SSH | false        | 默认不禁用ssh |\n\n## 六、运行\n\n### 6.1 单机Docker-compose方式运行\n\n```bash\n# 启动服务\nmake run\n\n# 查看服务状态\nmake ps\n\n# 查看服务日志\ndocker-compose logs -f gitea\n\n```\n\n\u003c!-- 这里写应用的【make命令的备注信息】位于文档最后端 --\u003e\n**说明:**\n\n- 启动成功后，打开浏览器输入 `http://\u003c你的IP\u003e:8080` 访问管理后台\n- 默认用户名：`gitea`，默认密码：`pass4Gitea`\n- [VERSION](https://github.com/quicklyon/gitea-docker/blob/main/VERSION) 文件中详细的定义了Makefile可以操作的版本。\n- [docker-compose.yml](https://github.com/quicklyon/gitea-docker/blob/main/docker-compose.yml)。\n\n## 七、版本升级\n\n\u003c!-- 这里是应用的【应用升级】信息，通过命令维护，详情参考：https://github.com/quicklyon/doc-toolkit --\u003e\n容器镜像已为版本升级做了特殊处理，当检测数据（数据库/持久化文件）版本与镜像内运行的程序版本不一致时，会进行数据库结构的检查，并自动进行数据库升级操作。\n\n因此，升级版本只需要更换镜像版本号即可：\n\n\u003e 修改 docker-compose.yml 文件\n\n```diff\n...\n  gitea:\n-    image: easysoft/gitea:1.17.0-20220729\n+    image: easysoft/gitea:1.17.1-20220822\n    container_name: gitea\n...\n```\n\n更新服务\n\n```bash\n# 是用新版本镜像更新服务\ndocker-compose up -d\n\n# 查看服务状态和镜像版本\ndocker-compose ps\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquicklyon%2Fgitea-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fquicklyon%2Fgitea-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquicklyon%2Fgitea-docker/lists"}