Document MSSQL database preparation (#636)

The database preparation page covered only MySQL and PostgreSQL. MSSQL setups without schema permissions break on upgrades, like in https://github.com/go-gitea/gitea/issues/40256. The new section shows the login, database and user setup with the roles Gitea needs, for main and 28, including zh-cn and zh-tw. _Written by Claude (Opus 5.5)._ Reviewed-on: https://gitea.com/gitea/docs/pulls/636 Reviewed-by: Lunny Xiao <[email protected]> Co-authored-by: silverwind <[email protected]>
2026-11-13 21:33:44 +00:00 · 2026-11-06 17:12:50 +00:00
1 parent 46b5401a81
commit 71869c6e24
@@ -8,7 +8,7 @@ aliases:

 # 数据库准备

-在使用 Gitea 前，您需要准备一个数据库。Gitea 支持 PostgreSQL（>= 12）、MySQL（>= 8.0）、MariaDB（>= 10.4）、SQLite（内置） 和 MSSQL（>= 2012 SP4）这几种数据库。本页将指导您准备数据库。由于 PostgreSQL 和 MySQL 在生产环境中被广泛使用，因此本文档将仅涵盖这两种数据库。如果您计划使用 SQLite，则可以忽略本章内容。
+在使用 Gitea 前，您需要准备一个数据库。Gitea 支持 PostgreSQL（>= 12）、MySQL（>= 8.0）、MariaDB（>= 10.4）、SQLite（内置） 和 MSSQL（>= 2012 SP4）这几种数据库。本页将指导您准备数据库。本文档涵盖 PostgreSQL、MySQL 和 MSSQL。如果您计划使用 SQLite，则可以忽略本章内容。

 如果您使用不受支持的数据库版本，请通过 [联系我们](/help/support) 以获取有关我们的扩展支持的信息。我们可以为旧数据库提供测试和支持，并将这些修复集成到 Gitea 代码库中。

@@ -168,6 +168,28 @@ aliases:

   您应该会被提示输入数据库用户的密码，并连接到数据库。

+## MSSQL
+
+1. 以管理员身份创建登录名、使用大小写敏感排序规则的数据库及其用户。请将密码 `'gitea'` 替换为安全的密码：
+
+   ```sql
+   CREATE LOGIN gitea WITH PASSWORD = 'gitea';
+   CREATE DATABASE giteadb COLLATE Latin1_General_CS_AS;
+   GO
+   USE giteadb;
+   CREATE USER gitea FOR LOGIN gitea;
+   ALTER ROLE db_owner ADD MEMBER gitea;
+   GO
+   ```
+
+   升级会更改数据库结构，因此该用户需要 `db_owner`，或者 `db_ddladmin`、`db_datareader` 和 `db_datawriter`。使用后者时，还需以管理员身份执行 `ALTER DATABASE giteadb SET READ_COMMITTED_SNAPSHOT ON;`。
+
+2. 在您的 Gitea 服务器上，测试与数据库的连接：
+
+   ```sh
+   sqlcmd -S 203.0.113.3 -U gitea -d giteadb
+   ```
+
 ## 使用 TLS 进行数据库连接

 如果 Gitea 和您的数据库实例之间的通信是通过私有网络进行的，或者如果 Gitea 和数据库运行在同一台服务器上，那么可以省略本节，因为 Gitea 和数据库实例之间的安全性不会受到严重威胁。但是，如果数据库实例位于公共网络上，请使用 TLS 对数据库连接进行加密，以防止第三方拦截流量数据。
@@ -8,7 +8,7 @@ aliases:

 # 数据库准备

-在使用 Gitea 前，您需要准备一个数据库。Gitea 支持 PostgreSQL（>= 12）、MySQL（>= 8.0）、MariaDB（>= 10.4）、SQLite（内置） 和 MSSQL（>= 2012 SP4）这几种数据库。本页将指导您准备数据库。由于 PostgreSQL 和 MySQL 在生产环境中被广泛使用，因此本文档将仅涵盖这两种数据库。如果您计划使用 SQLite，则可以忽略本章内容。
+在使用 Gitea 前，您需要准备一个数据库。Gitea 支持 PostgreSQL（>= 12）、MySQL（>= 8.0）、MariaDB（>= 10.4）、SQLite（内置） 和 MSSQL（>= 2012 SP4）这几种数据库。本页将指导您准备数据库。本文档涵盖 PostgreSQL、MySQL 和 MSSQL。如果您计划使用 SQLite，则可以忽略本章内容。

 如果您使用不受支持的数据库版本，请通过 [联系我们](/help/support) 以获取有关我们的扩展支持的信息。我们可以为旧数据库提供测试和支持，并将这些修复集成到 Gitea 代码库中。

@@ -168,6 +168,28 @@ aliases:

   您应该会被提示输入数据库用户的密码，并连接到数据库。

+## MSSQL
+
+1. 以管理员身份创建登录名、使用大小写敏感排序规则的数据库及其用户。请将密码 `'gitea'` 替换为安全的密码：
+
+   ```sql
+   CREATE LOGIN gitea WITH PASSWORD = 'gitea';
+   CREATE DATABASE giteadb COLLATE Latin1_General_CS_AS;
+   GO
+   USE giteadb;
+   CREATE USER gitea FOR LOGIN gitea;
+   ALTER ROLE db_owner ADD MEMBER gitea;
+   GO
+   ```
+
+   升级会更改数据库结构，因此该用户需要 `db_owner`，或者 `db_ddladmin`、`db_datareader` 和 `db_datawriter`。使用后者时，还需以管理员身份执行 `ALTER DATABASE giteadb SET READ_COMMITTED_SNAPSHOT ON;`。
+
+2. 在您的 Gitea 服务器上，测试与数据库的连接：
+
+   ```sh
+   sqlcmd -S 203.0.113.3 -U gitea -d giteadb
+   ```
+
 ## 使用 TLS 进行数据库连接

 如果 Gitea 和您的数据库实例之间的通信是通过私有网络进行的，或者如果 Gitea 和数据库运行在同一台服务器上，那么可以省略本节，因为 Gitea 和数据库实例之间的安全性不会受到严重威胁。但是，如果数据库实例位于公共网络上，请使用 TLS 对数据库连接进行加密，以防止第三方拦截流量数据。
@@ -8,7 +8,7 @@ aliases:

 # 資料庫準備

-在使用 Gitea 前，您需要準備一個資料庫。Gitea 支援 PostgreSQL（>= 12）、MySQL（>= 8.0）、MariaDB（>= 10.4）、SQLite（內置） 和 MSSQL（>= 2012 SP4）這幾種資料庫。本頁將指導您準備資料庫。由於 PostgreSQL 和 MySQL 在生產環境中被廣泛使用，因此本文件將僅涵蓋這兩種資料庫。如果您計劃使用 SQLite，則可以忽略本章內容。
+在使用 Gitea 前，您需要準備一個資料庫。Gitea 支援 PostgreSQL（>= 12）、MySQL（>= 8.0）、MariaDB（>= 10.4）、SQLite（內置） 和 MSSQL（>= 2012 SP4）這幾種資料庫。本頁將指導您準備資料庫。本文件涵蓋 PostgreSQL、MySQL 和 MSSQL。如果您計劃使用 SQLite，則可以忽略本章內容。

 如果您使用不受支援的資料庫版本，請通過 [聯繫我們](/help/support) 以獲取有關我們的擴展支援的資訊。我們可以為舊資料庫提供測試和支援，並將這些修復整合到 Gitea 程式碼庫中。

@@ -168,6 +168,28 @@ aliases:

   您應該會被提示輸入資料庫使用者的密碼，並連接到資料庫。

+## MSSQL
+
+1. 以管理員身份建立登入名稱、使用大小寫敏感排序規則的資料庫及其使用者。請將密碼 `'gitea'` 替換為安全的密碼：
+
+   ```sql
+   CREATE LOGIN gitea WITH PASSWORD = 'gitea';
+   CREATE DATABASE giteadb COLLATE Latin1_General_CS_AS;
+   GO
+   USE giteadb;
+   CREATE USER gitea FOR LOGIN gitea;
+   ALTER ROLE db_owner ADD MEMBER gitea;
+   GO
+   ```
+
+   升級會更改資料庫結構，因此該使用者需要 `db_owner`，或者 `db_ddladmin`、`db_datareader` 和 `db_datawriter`。使用後者時，還需以管理員身份執行 `ALTER DATABASE giteadb SET READ_COMMITTED_SNAPSHOT ON;`。
+
+2. 在您的 Gitea 伺服器上，測試與資料庫的連接：
+
+   ```sh
+   sqlcmd -S 203.0.113.3 -U gitea -d giteadb
+   ```
+
 ## 使用 TLS 進行資料庫連接

 如果 Gitea 和您的資料庫實例之間的通信是通過私有網路進行的，或者如果 Gitea 和資料庫運行在同一臺伺服器上，那麼可以省略本節，因為 Gitea 和資料庫實例之間的安全性不會受到嚴重威脅。但是，如果資料庫實例位於公共網路上，請使用 TLS 對資料庫連接進行加密，以防止第三方攔截流量資料。
@@ -8,7 +8,7 @@ aliases:

 # 資料庫準備

-在使用 Gitea 前，您需要準備一個資料庫。Gitea 支援 PostgreSQL（>= 12）、MySQL（>= 8.0）、MariaDB（>= 10.4）、SQLite（內置） 和 MSSQL（>= 2012 SP4）這幾種資料庫。本頁將指導您準備資料庫。由於 PostgreSQL 和 MySQL 在生產環境中被廣泛使用，因此本文件將僅涵蓋這兩種資料庫。如果您計劃使用 SQLite，則可以忽略本章內容。
+在使用 Gitea 前，您需要準備一個資料庫。Gitea 支援 PostgreSQL（>= 12）、MySQL（>= 8.0）、MariaDB（>= 10.4）、SQLite（內置） 和 MSSQL（>= 2012 SP4）這幾種資料庫。本頁將指導您準備資料庫。本文件涵蓋 PostgreSQL、MySQL 和 MSSQL。如果您計劃使用 SQLite，則可以忽略本章內容。

 如果您使用不受支援的資料庫版本，請通過 [聯繫我們](/help/support) 以獲取有關我們的擴展支援的資訊。我們可以為舊資料庫提供測試和支援，並將這些修復整合到 Gitea 程式碼庫中。

@@ -168,6 +168,28 @@ aliases:

   您應該會被提示輸入資料庫使用者的密碼，並連接到資料庫。

+## MSSQL
+
+1. 以管理員身份建立登入名稱、使用大小寫敏感排序規則的資料庫及其使用者。請將密碼 `'gitea'` 替換為安全的密碼：
+
+   ```sql
+   CREATE LOGIN gitea WITH PASSWORD = 'gitea';
+   CREATE DATABASE giteadb COLLATE Latin1_General_CS_AS;
+   GO
+   USE giteadb;
+   CREATE USER gitea FOR LOGIN gitea;
+   ALTER ROLE db_owner ADD MEMBER gitea;
+   GO
+   ```
+
+   升級會更改資料庫結構，因此該使用者需要 `db_owner`，或者 `db_ddladmin`、`db_datareader` 和 `db_datawriter`。使用後者時，還需以管理員身份執行 `ALTER DATABASE giteadb SET READ_COMMITTED_SNAPSHOT ON;`。
+
+2. 在您的 Gitea 伺服器上，測試與資料庫的連接：
+
+   ```sh
+   sqlcmd -S 203.0.113.3 -U gitea -d giteadb
+   ```
+
 ## 使用 TLS 進行資料庫連接

 如果 Gitea 和您的資料庫實例之間的通信是通過私有網路進行的，或者如果 Gitea 和資料庫運行在同一臺伺服器上，那麼可以省略本節，因為 Gitea 和資料庫實例之間的安全性不會受到嚴重威脅。但是，如果資料庫實例位於公共網路上，請使用 TLS 對資料庫連接進行加密，以防止第三方攔截流量資料。