svnserver配置文件详解

封面图 • 2025-12-06 • SVN

SVNServer（Subversion Server）是用于管理版本控制的服务器软件，通常通过 `svnserve` 进程运行。它可以通过配置文件来定义用户权限、访问控制、仓库路径等。

下面是对 SVNServer 配置文件的详细解析：

---

## 一、SVNServer 的主要配置文件

SVNServer 的配置文件通常是 `svnserve.conf`，这个文件位于 **每个仓库的 `conf/` 目录下**（即 `<repo>/conf/svnserve.conf`）。

此外，还有两个与用户认证相关的文件：

- `authz`：用于定义权限规则（谁可以访问哪些路径）。
- `passwd`：用于存储用户名和密码。

---

## 二、`svnserve.conf` 配置详解

### 1. 基本结构

```ini
[general]
anon-access = none
auth-access = write
password-db = passwd
authz-db = authz
realm = My First Repository
```

### 2. 各字段说明

| 字段名 | 说明 |
|--------|------|
| `[general]` | 表示全局配置块，所有配置项都写在这一块中。 |
| `anon-access` | 匿名访问权限，可选值：`none`（禁止）、`read`（只读）、`write`（读写）。 |
| `auth-access` | 认证用户访问权限，可选值：`none`、`read`、`write`。 |
| `password-db` | 指定用户密码文件路径，默认为 `passwd`，通常在同目录下。 |
| `authz-db` | 指定权限控制文件路径，默认为 `authz`。 |
| `realm` | 认证域名称，用于区分不同的仓库或系统。 |

---

## 三、`passwd` 文件格式

该文件用于存储用户名和密码，格式如下：

```
[users]
admin = mypassword
user1 = userpass
```

- `[users]` 是必须的头部。
- 每一行是一个用户，格式为 `用户名 = 密码`。
- 密码以明文形式存储（不推荐），建议使用加密方式（如 `svnpasswd` 工具）。

---

## 四、`authz` 文件格式

该文件用于定义用户的访问权限，格式如下：

```
[groups]
devs = admin, user1
admins = admin

[/]
@devs = rw
@admin = rw
* = r
```

### 1. 说明

- `[groups]`：定义用户组。
- `[/]`：表示根目录下的权限设置。
- `@groupname`：表示某个用户组。
- `*`：表示所有用户。
- 权限类型：
  - `r`：只读
  - `w`：写入
  - `rw`：读写
  - `=`：覆盖默认权限（如 `@devs = rw`）

---

## 五、启动 SVNServer

你可以通过以下命令启动 SVNServer：

```bash
svnserve -d -r /path/to/repository
```

- `-d`：以守护进程方式运行。
- `-r`：指定仓库根目录。

也可以将配置添加到 `/etc/sysconfig/svnserve` 或使用 systemd 管理服务。

---

## 六、常见配置示例

### 示例 1：允许认证用户读写，禁止匿名访问

```ini
[general]
anon-access = none
auth-access = write
password-db = passwd
authz-db = authz
realm = MyRepo
```

### 示例 2：限制某用户只能读取

```ini
[groups]
devs = user1

[/]
@devs = r
* = none
```

---

## 七、注意事项

- `svnserve.conf` 中的 `password-db` 和 `authz-db` 默认是相对路径，如果不在同一目录下，需要提供绝对路径。
- 不建议将密码明文存储，应使用 `svnpasswd` 工具生成加密密码。
- `authz` 文件中的路径匹配是基于子路径的，例如 `/trunk` 会继承 `/` 的权限。

---

## 八、常用命令

| 命令 | 说明 |
|------|------|
| `svnserve -d -r /path/to/repo` | 启动 SVN 服务 |
| `svnserve --help` | 查看帮助信息 |
| `svnpasswd` | 管理用户密码（生成加密密码） |

---

如果你有特定的配置需求（比如多仓库、SSL 加密、Apache 集成等），可以告诉我，我可以进一步为你讲解。