如何使用单个同步账号通过SubGit同步GitLab所有关联Subversion的仓库并隐藏凭证？

核心配置逻辑 #

• 拆分两类账号的作用：专用同步服务账号仅用于SVN权限校验，不参与提交作者生成；各项目原有作者映射逻辑独立保留。
• 废弃单项目明文subgit/passwd配置，改用SubGit全局加密凭证存储，实现所有仓库共用同一套同步凭证。

全局统一加密凭证配置（解决明文存储、多项目复用问题） #

操作前提：停止所有已部署的SubGit同步服务，避免配置冲突

• 切换到运行SubGit服务的系统用户（通常为GitLab部署使用的git用户）
• 执行以下命令添加专用同步服务账号的加密凭证：

  subgit credentials add --svn-url <你的SVN服务根地址，比如svn://svn.company.com> --username <专用同步服务账号名>
  

• 交互式输入同步服务账号的SVN密码，SubGit会将加密后的凭证存储在当前用户的全局配置目录~/.subgit/credentials，该文件默认权限为仅当前用户可读写，无明文泄露风险。
• 删除所有已配置项目下的subgit/passwd文件里的SVN凭证字段，全局凭证会自动对当前用户部署的所有SubGit项目生效，只要SVN地址匹配预设的根地址范围，就会自动使用该账号鉴权，无需逐个项目配置。

作者信息保留配置 #

注意：同步服务账号仅用于权限校验，不会作为提交作者写入记录，默认配置即可保留原有作者信息，无需额外修改核心同步逻辑

• 每个项目的作者映射表（subgit/authors.map）为项目独立配置，不受全局同步账号影响，原有已配置的SVN与Git作者对应规则可直接保留。
• 若需调整单项目的作者对应关系，直接修改该项目下的subgit/authors.map即可，格式示例：

  svn_zhangsan = 张三 <zhangsan@company.com>
  

• 禁止将项目subgit/config中[auth "svn"]段的default-author配置为同步服务账号，保持默认空值即可自动映射原提交作者。

批量映射所有GitLab与SVN项目 #

• 先整理所有SVN项目与GitLab仓库的映射关系表，明确每个SVN项目地址对应的GitLab本地仓库路径（通常为/var/opt/gitlab/git-data/repositories/<组名>/<项目名>.git）。
• 对未初始化SubGit的Git仓库，执行配置命令时无需单独指定SVN凭证，全局加密凭证会自动生效：

  subgit configure --svn-url <对应项目的SVN地址> <GitLab本地仓库绝对路径>
  

• 配置完成后执行subgit install启动双向同步服务即可。
• 对之前已测试完成的单项目，仅需删除项目下subgit/passwd中的明文凭证，执行subgit restart重启同步服务，即可切换为使用全局加密凭证同步。

凭证安全加固 #

• 保持全局SubGit配置目录~/.subgit/的权限为700，仅允许运行SubGit的系统用户访问，禁止其他用户读取。
• 如需更新同步服务账号密码，仅需执行以下命令一次性更新所有项目的凭证，无需逐个项目修改：

  subgit credentials update --svn-url <SVN服务根地址> --username <专用同步服务账号名>
  

• 禁止将全局凭证文件、项目下的subgit/authors.map等配置文件提交到任何公开版本控制仓库。

内容的提问来源于stack exchange，提问作者DollarTinky