svn服务器配置文件

SVN服务器核心配置文件详解

svnserve.conf（主配置文件）

此文件位于版本库的conf目录下，是SVN服务的核心配置，仅包含一个[general]段落，主要参数如下：

| 参数名 | 作用 | 可选值 | 默认值 | 示例 |

|—————–|———————————————————————-|———————-|————–|————————–|

| anon-access | 控制未认证用户的访问权限 | none/read/write| read | anon-access = none |

| auth-access | 已认证用户的访问权限 | none/read/write| write | auth-access = write |

| password-db | 指定存储用户名和密码的文件路径（相对或绝对路径） | | passwd | password-db = passwd |

| authz-db | 定义基于路径的细粒度权限控制文件路径 | | authz | authz-db = authz |

| realm | 认证域名称（客户端登录时显示的提示信息） | | 自动生成UUID | realm = myrepo |

说明：修改前建议备份原文件,防止配置错误导致服务不可用。

passwd（用户密码文件）

由svnserve.conf中的password-db指定位置，默认与svnserve.conf同目录,格式为：

[users] username1 = plaintext_password username2 = another_password

注意：密码以明文存储，生产环境建议结合加密工具（如htpasswd）增强安全性,例如创建带加密的用户：

htpasswd -c /path/to/passwd user1 # 首次创建并写入用户user1 htpasswd /path/to/passwd user2 # 追加用户user2

authz（权限控制文件）

通过authz-db参数关联,支持两种类型的配置段：

1. 用户组定义（[groups]段落）： [groups] admins = alice,bob@devteam # 将多个用户或组加入同一权限集合
2. 路径级权限规则（以仓库路径为键）： [repository_name:/path/in/repo] charlie = rw # 用户charlie拥有读写权限 @admins = rw # 用户组admins继承权限 = r # 其他所有用户仅读

   特殊符号：代表全体用户，@组名引用预定义的用户组。

   

钩子脚本（Hooks）

位于版本库的hooks目录，可在特定事件触发自定义操作，常用钩子包括：

| 钩子名称 | 触发时机 | 典型用途 |

|—————-|——————————|——————————|

| pre-commit | 提交前执行 | 代码质量检查、语法验证 |

| post-commit | 提交后执行 | 发送通知邮件、触发CI构建 |

| start-commit | 开始提交事务时 | 锁定资源防止冲突 |

相关问题与解答

Q1: 如何限制某个分支仅允许特定角色访问？

A: 在authz文件中为目标分支路径设置独立权限段，若需禁止开发组以外的用户修改/features分支：

[myrepo:/features] @developers = rw # 开发者可读写 = r # 其他人仅读

同时确保svnserve.conf中auth-access未全局禁用写权限。

Q2: 修改配置后服务未生效怎么办？

A: 按以下顺序排查：

1️⃣ 确认配置文件语法正确性（可通过svnlook plist <config>验证）；

2️⃣ 检查文件权限是否允许SVN进程读取（通常需归svn用户所有）；

3️⃣ 重启服务进程：sudo systemctl restart subversion（系统级安装）或直接终止旧进程并启动新实例；

4️⃣ 查看日志文件（默认位于/var/log/subversion/），定位错误