date: "2016-11-08T16:00:00+02:00" title: "文件" slug: "documentation" url: "/zh-tw/" weight: 10 toc: false

draft: false

關於 Gitea

Gitea 是一個可自行託管的 Git 服務。你可以拿 GitHub、Bitbucket 或 Gitlab 來比較看看。
Gitea 是從 Gogs Fork 出來的，請閱讀部落格文章 Gitea 公告以了解我們 Fork 的理由。

目標

本專案的首要目標是建立一個容易安裝，執行快速，安装和使用體驗良好的自建 Git 服務。我們採用 GO 為後端語言，Go 可以產生各平台使用的執行檔。它支援 Linux、macOS 和 Windows 外，處理器架構包含 amd64、i386、ARM 和 PowerPC 等。

功能

• 使用者面板

  • 內容切換（組織或目前使用者）
  • 動態時間軸
  • 提交
  • 問題
  • 合併請求
  • 儲存庫的建立
  • 可搜尋的儲存庫清單
  • 組織清單
  • 鏡像儲存庫清單

• 問題面板

  • 內容切換（組織或目前使用者）
  • 篩選器
  • 開放中
  • 已關閉
  • 您的儲存庫
  • 被指派的問題
  • 您的問題
  • 儲存庫
  • 排序
  • 最舊
  • 最近更新
  • 留言數量

• 合併請求面板

  • 和問題面板相同

• 儲存庫類型

  • 鏡像
  • 一般
  • 已遷移

• 通知（email 和網頁）

  • 已讀
  • 未讀
  • 釘選

• 探索頁面

  • 使用者
  • 儲存庫
  • 組織
  • 搜尋

• 自訂範本

• 複寫 public 檔案（logo, css 等）

• CSRF 與 XSS 保護

• 支援 HTTPS

• 設定允許上傳的檔案大小和類型

• 日誌

• 組態

  • 資料庫
  • MySQL
  • PostgreSQL
  • SQLite3
  • MSSQL
  • TiDB（MySQL 協議）
  • 設定檔
  • app.ini
  • 管理員面板
  • 系統摘要
  • 維護操作
    • 刪除未啟用帳戶
    • 刪除快取的儲存庫存檔
    • 刪除遺失 Git 檔案的儲存庫
    • 對儲存庫進行垃圾回收
    • 重寫 SSH 金鑰
    • 重新同步 hooks
    • 重新建立遺失的儲存庫
  • 伺服器狀態
    • 執行時間
    • 記憶體
    • 目前的 Goroutines 數量
    • 還有更多……
  • 使用者管理
    • 搜尋
    • 排序
    • 最後登入時間
    • 認證來源
    • 儲存庫上限
    • 停用帳戶
    • 管理員權限
    • 建立 Git Hook 的權限
    • 建立組織的權限
    • 匯入儲存庫的權限
  • 組織管理
    • 成員
    • 團隊
    • 大頭貼
    • Hook
  • 儲存庫管理
    • 查看所有儲存庫資訊和管理儲存庫
  • 認證來源
    • OAuth
    • PAM
    • LDAP
    • SMTP
  • 組態檢視器
    • 所有設定檔中的值
  • 系統提示
    • 當有未預期的事情發生時
  • 應用監控面板
    • 目前的處理程序
    • Cron 任務
    • 更新鏡像
    • 儲存庫健康檢查
    • 檢查儲存庫的統計資料
    • 刪除舊的儲存庫存檔
  • 環境變數
  • 命令列選項

• 支援多國語言 (21 種語言)

• 支援 Mermaid 圖表

• 郵件服務

  • 通知
  • 確認註冊
  • 重設密碼

• 支援反向代理（Reverse Proxy）

  • 包含子路徑

• 使用者

  • 個人資料
  • 姓名
  • 帳號
  • 電子信箱
  • 網站
  • 加入日期
  • 追蹤者和追蹤中
  • 組織
  • 儲存庫
  • 動態
  • 已加星號的儲存庫
  • 設定
  • 和個人資料相同並包含下列功能
  • 隱藏電子信箱
  • 大頭貼
    • Gravatar
    • Libravatar
    • 自訂
  • 密碼
  • 多個電子信箱
  • SSH 金鑰
  • 已連結的應用程式
  • 兩步驟驗證
  • 已連結 OAuth2 來源
  • 刪除帳戶

• 儲存庫

  • 以 SSH/HTTP/HTTPS Clone
  • Git LFS
  • 關注、星號、Fork
  • 檢視關注、已加星號、Fork 的使用者
  • 程式碼
  • 瀏覽分支
  • 從網頁上傳和建立檔案
  • Clone url
  • 下載
    • ZIP
    • TAR.GZ
  • 網頁程式碼編輯器
    • Markdown 編輯器
    • 文本編輯器
    • 語法高亮
    • 預覽差異
    • 預覽
    • 選擇提交目標分支
  • 檢視檔案歷史
  • 刪除檔案
  • 檢視 raw
  • 問題
  • 問題範本
  • 里程碑
  • 標籤
  • 指派問題
  • 時間追蹤
  • 表情反應
  • 篩選器
    • 開放中
    • 已關閉
    • 被指派的人
    • 您的問題
    • 提及您
  • 排序
    • 最舊
    • 最近更新
    • 留言數量
  • 搜尋
  • 留言
  • 附件
  • 合併請求
  • 功能和問題相同
  • 提交
  • 提交線圖
  • 不同分支的提交
  • 搜尋
  • 在所有分支中搜尋
  • 檢視差異（diff）
  • 檢視 SHA
  • 檢視作者（author）
  • 瀏覽提交中的檔案
  • 版本發佈
  • 附件
  • 標題
  • 內容
  • 刪除
  • 標記為 pre-release
  • 選擇分支
  • Wiki
  • 匯入
  • Markdown 編輯器
  • 設定
  • 選項
    • 名稱
    • 描述
    • 私有/公開
    • 網站
    • Wiki
    • 開啟/關閉
    • 內部/外部
    • 問題
    • 開啟/關閉
    • 內部/外部
    • 外部問題追蹤器支援 URL 重寫（URL Rewrite）以獲得更好的整合性
    • 開啟/關閉合併請求
    • 轉移儲存庫所有權
    • 刪除 wiki
    • 刪除儲存庫
  • 協作者
    • 讀取/寫入/管理員
  • 分支
    • 預設分支
    • 分支保護
  • Webhook
  • Git hook
  • 部署金鑰

系統需求

• Raspberry Pi 3 的效能足夠讓 Gitea 承擔小型工作負載。

• 雙核心 CPU 和 1GB 記憶體通常足以應付小型團隊/專案。

• 在類 UNIX 系統上， 應該以專用的非 root 系統帳號來執行 Gitea。

  • 備註：Gitea 管理著 ~/.ssh/authorized_keys 檔案。以一般身份使用者執行 Gitea 可能會破壞該使用者的登入能力。

• Git 的最低需求為 2.0 或更新版本。

  • 當 git 版本 >= 2.1.2 時，可啟用 Git large file storage。
  • 當 git 版本 >= 2.18 時，將自動啟用 Git 提交線圖渲染。

瀏覽器支援

• 最近 2 個版本的 Chrome, Firefox, Safari, Edge
• Firefox ESR

元件

• Web 框架： Chi
• ORM： XORM
• UI 元件：
  • jQuery
  • Fomantic UI
  • Vue2
  • CodeMirror
  • EasyMDE
  • Monaco Editor
  • ... (package.json)
• 資料庫驅動程式：
  • github.com/go-sql-driver/mysql
  • github.com/lib/pq
  • github.com/mattn/go-sqlite3
  • github.com/denisenkom/go-mssqldb

軟體和服務支援

• Drone (CI)