mirror of
https://gitea.com/gitea/docs.git
synced 2026-11-06 18:10:36 +00:00
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]>
This commit is contained in:
silverwind authored and 
Lunny Xiao committed
1 parent
46b5401a81
commit
71869c6e24
6 files changed
+138
-6
No files matched your search
@@ -8,7 +8,7 @@ aliases:
|
||||
|
||||
# Database Preparation
|
||||
|
||||
You need a database to use Gitea. Gitea supports PostgreSQL (>= 12), MySQL (>= 8.0), MariaDB (>= 10.4), SQLite (builtin), and MSSQL (>= 2012 SP4). This page will guide into preparing database. Only PostgreSQL and MySQL will be covered here since those database engines are widely-used in production. If you plan to use SQLite, you can ignore this chapter.
|
||||
You need a database to use Gitea. Gitea supports PostgreSQL (>= 12), MySQL (>= 8.0), MariaDB (>= 10.4), SQLite (builtin), and MSSQL (>= 2012 SP4). This page will guide into preparing database. PostgreSQL, MySQL and MSSQL are covered here. If you plan to use SQLite, you can ignore this chapter.
|
||||
|
||||
:::warning
|
||||
Converting one database type to another is not a well-tested process and you may experience issues. It is better to choose the final database type at the type of the first installation. Be aware that SQLite does not scale; if you expect your instance to grow at a later time, you should choose another database type.
|
||||
@@ -177,6 +177,28 @@ All steps below requires that the database engine of your choice is installed on
|
||||
|
||||
You should be prompted to enter password for the database user, and connected to the database.
|
||||
|
||||
## MSSQL
|
||||
|
||||
1. As an administrator, create the login, a database with case-sensitive collation, and its user. Replace the password `'gitea'` with a secure one:
|
||||
|
||||
```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
|
||||
```
|
||||
|
||||
Upgrades change the database schema, so the user needs `db_owner`, or `db_ddladmin`, `db_datareader` and `db_datawriter`. With the latter, also run `ALTER DATABASE giteadb SET READ_COMMITTED_SNAPSHOT ON;` as administrator.
|
||||
|
||||
2. On your Gitea server, test the connection to the database:
|
||||
|
||||
```sh
|
||||
sqlcmd -S 203.0.113.3 -U gitea -d giteadb
|
||||
```
|
||||
|
||||
## Database Connection over TLS
|
||||
|
||||
If the communication between Gitea and your database instance is performed through a private network, or if Gitea and the database are running on the same server, this section can be omitted since the security between Gitea and the database instance is not critically exposed. If instead the database instance is on a public network, use TLS to encrypt the connection to the database, as it is possible for third-parties to intercept the traffic data.
|
||||
|
||||
@@ -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 對資料庫連接進行加密，以防止第三方攔截流量資料。
|
||||
|
||||
@@ -8,7 +8,7 @@ aliases:
|
||||
|
||||
# Database Preparation
|
||||
|
||||
You need a database to use Gitea. Gitea supports PostgreSQL (>= 12), MySQL (>= 8.0), MariaDB (>= 10.4), SQLite (builtin), and MSSQL (>= 2012 SP4). This page will guide into preparing database. Only PostgreSQL and MySQL will be covered here since those database engines are widely-used in production. If you plan to use SQLite, you can ignore this chapter.
|
||||
You need a database to use Gitea. Gitea supports PostgreSQL (>= 12), MySQL (>= 8.0), MariaDB (>= 10.4), SQLite (builtin), and MSSQL (>= 2012 SP4). This page will guide into preparing database. PostgreSQL, MySQL and MSSQL are covered here. If you plan to use SQLite, you can ignore this chapter.
|
||||
|
||||
:::warning
|
||||
Converting one database type to another is not a well-tested process and you may experience issues. It is better to choose the final database type at the type of the first installation. Be aware that SQLite does not scale; if you expect your instance to grow at a later time, you should choose another database type.
|
||||
@@ -177,6 +177,28 @@ All steps below requires that the database engine of your choice is installed on
|
||||
|
||||
You should be prompted to enter password for the database user, and connected to the database.
|
||||
|
||||
## MSSQL
|
||||
|
||||
1. As an administrator, create the login, a database with case-sensitive collation, and its user. Replace the password `'gitea'` with a secure one:
|
||||
|
||||
```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
|
||||
```
|
||||
|
||||
Upgrades change the database schema, so the user needs `db_owner`, or `db_ddladmin`, `db_datareader` and `db_datawriter`. With the latter, also run `ALTER DATABASE giteadb SET READ_COMMITTED_SNAPSHOT ON;` as administrator.
|
||||
|
||||
2. On your Gitea server, test the connection to the database:
|
||||
|
||||
```sh
|
||||
sqlcmd -S 203.0.113.3 -U gitea -d giteadb
|
||||
```
|
||||
|
||||
## Database Connection over TLS
|
||||
|
||||
If the communication between Gitea and your database instance is performed through a private network, or if Gitea and the database are running on the same server, this section can be omitted since the security between Gitea and the database instance is not critically exposed. If instead the database instance is on a public network, use TLS to encrypt the connection to the database, as it is possible for third-parties to intercept the traffic data.
|
||||
|
||||
Reference in new issue
Block a user