1.背景
本人团队原来使用VisualSVN工具搭建svn服务器，随着时间的增长，windows的磁盘空间越来越大，最后满了，也不太好扩容（当然如果想扩容，最终肯定是可以实现的）。为了以后更好的svn容量管理，就开始新搭建一台linux服务器，将svn数据单独放存储上，这样后期扩容就很方便了。
简单一句就是：从VisualSVN迁移数据至Linux版svn中。
2.原有功能
- 协议为http://方式（web方式或客户端方式均支持）
- 可在线修改用户自己口令
- 库名都是中文的
3.安装过程
3.1.软件版本
为支持原有功能，本人先在网上搜索了很多，然后参考linux下apache+SVN搭建完美版进行搭建。
当然本次迁移，本人使用了最新的软件版本，清单如下：
- Apr: apr-1.5.2和apr-util-1.5.4
- Apache: httpd-2.4.25
- Subversion: subversion-1.9.5
- Zlib: zlib-1.2.11
- Sqlite: sqlite-autoconf-3170000
- Pcre: pcre-8.40
各个软件包可以在官网下载，如何解压见参考文。
3.2.软件编译参数
上述各个软件编译时的参数清单如下（有软件有安装顺序）：
- ./configure --prefix=/svn/bin/apr/
- ./configure --prefix=/svn/bin/apr-util/ --with-apr=/svn/bin/apr/
- ./configure --prefix=/svn/bin/sqlite/
- ./configure --prefix=/svn/bin/zlib/
- ./configure --prefix=/svn/bin/pcre/
- ./configure --prefix=/svn/bin/httpd/ --enable-so --enable-dav --enable-dav-fs --enable-maintainer-mode --enable-deflate=shared --enable-expires=shared --enable-headers=shared --enable-rewrite=shared --enable-static-support --with-mpm=prefork --enable-cache --enable-file-cache --enable-rewrite --enable-ssl --enable-proxy --enable-proxy-http --with-apr=/svn/bin/apr/ --with-apr-util=/svn/bin/apr-util/ --with-sqlite=/svn/bin/sqlite/ --with-pcre=/svn/bin/pcre/
- ./configure --prefix=/svn/bin/svn --with-apr=/svn/bin/apr --with-apr-util=/svn/bin/apr-util/ --with-sqlite=/svn/bin/sqlite/ --with-zlib=/svn/bin/zlib/ --with-apxs=/svn/bin/httpd/bin/apxs --with-apache-libexecdir=/svn/bin/httpd/modules --enable-mod-activation
具体各个参数含义，可通过./configure --help显示，或者查找官方说明。
安装及后续配置时建议均使用同一个用户，如本文的svnapp用户，就会少很多目录权限的问题。
3.3.安装完结果
按照上述安装完后，如果没有异常发生，那么应该存在以下重要信息：
- /svn/bin/httpd/modules/目录下应有mod_dav_svn.so和mod_zuthz_svn.so两个文件
- /svn/bin/httpd/conf/httpd.conf文件中已经自动LoadModule上面2个*.so文件
4.配置过程
4.1.svn建库
mkdir -p /svndata/Repositories/测试;
/svn/bin/svn/bin/svnadmin create --pre-1.6-compatible /svndata/Repositories/测试
为了与原有客户端兼容（原来VisualSVN为1.7版本），需添加--pre-1.6-xx参数或者--pre-1.7-xx参数
此时，【/svndata/Repositories/测试】目录下应自动生成一些配置文件。
验证svn是否可用：
将/svndata/Repositories/测试/conf/svnserve.conf中anon-access参数修改为write
然后启动svn【/svn/bin/svn/bin/svnserve -d -r /svndata/Repositories/】，使用svn客户端，如TortoiseSVN访问【svn://IP:9000/测试】应该可以正常访问，且可以新增文件或文件夹，表示svn使用正常
4.2.svn角色权限配置
参考文linux下apache+SVN搭建完美版中已经完美了。
本文中，用户及权限文件存放于【/svndata/Repositories/svn_conf/】目录下，文件名为authz及passwd（密码为明文，因为svn只支持明文）
然后修改【/svndata/Repositories/测试/conf/svnserve.conf】中对应的密码及权限文件，可以使用绝对路径，这样权限角色及密码就统一管理了。
如果只是使用一个库，那么就省去单独配置，直接使用conf下的配置文件进行配置即可。
4.3.apache配置
/svn/bin/httpd/conf/httpd.conf:
1、Listen 80修改为9000端口（如果使用80端口，则需要root用户启动） 2、User daemon及Group daemon分别修改为svnapp和svngrp，即svn建库用户与apaache启动用户为同一个，就不用chmod命令了 3、ServerName 修改为自己的IP地址 4、文件最后添加一行Include conf/httpd-svn.conf，把所有svn的配置都放在/svn/bin/httpd/conf/httpd-svn.conf文件中，方便管理
然后在conf目录中touch httpd-svn.conf
此时可以使用命令启动svn及httpd服务：
- /svn/bin/httpd/bin/apachectl -k start
可以使用ps -fu svnapp查看这些进程。
至此，apache和svn是独立启动访问的，保证都ok后，再往下走。
4.4.关联apache和svn
/svn/bin/httpd/conf/httpd-svn.conf：
SVNUseUTF8 On
DAV svn
SVNParentPath /svndata/Repositories
SVNListParentPath On
SVNIndexXSLT "/svnindex.xsl"
SVNPathAuthz short_circuit
AuthType Basic
AuthName "Subversion Repository"
AuthUserFile /svndata/Repositories/svn_conf/htpasswd
AuthzSVNAccessFile /svndata/Repositories/svn_conf/authz
Require valid-user
CustomLog logs/svn_logfile "%t %u %{SVN-ACTION}e" env=SVN-ACTION
大部分指令在参考网页中已经说明，现对特殊的简要说明：
- SVNUseUTF8指令是svn 1.8版本以后的新功能，告诉mod_dav_svn用utf8编码解析URL及文件名。此处若不添加，则可能会报【Can't convert string from 'UTF-8' to natvie encoding】的错，详情见why repository name should not be utf-8，此问题本人寻找了好几天，终于在某个网页上提及了这个指令，然后报着试一试的想法，果然能解决。
- SVNIndexXSLT指令表示web端访问时，要采用的样式，这是一个xml的文档定义表，即定义目录名、文件名、上一层等显示的css样式，本文使用的代码见后文。
- CustomLog指令为svn正常访问的日志重定向，可用可不用
然后使用htpasswd命令创建1个用户，然后设置好权限authz文件（这些均见参考网页）。
至此，应该可以使用“ http://IP:9000/svn/测试 ”在浏览器中访问了（可先把SVNIndexXSLT指令注释掉，再测试）
4.5.Web显示样式
这几个显示的样式文件及js文件，均从VisualSVN中复制过来，然后稍做修改而得
/svn/bin/httpd/htdocs/svnindex.xsl（从VisualSVN来，未修改）：
<xsl:if test="index/@base">
<xsl:text>代码库 </xsl:text>
<xsl:value-of select="index/@base" />
<xsl:text>:</xsl:text>
<xsl:value-of select="index/@path"/>
</xsl:if>
<xsl:if test="string-length(index/@base) = 0">
<xsl:text>仓库列表</xsl:text>
</xsl:if>
lnkModify
color:green;text-decoration:none;
javascript:doChange();void(0);
修改密码
color:green;text-decoration:none;
http://www.visualsvn.com/doc/
帮助文档
代码库
:
当前版本 Rev.
仓库列表
/svn/
返回仓库列表
..
..
/
该文件引用的文件有/svn/bin/httpd/htdocs/jquery.js，直接从官网下载压缩版的即可。
文件/svn/bin/httpd/htdocs/svnindex.css（从VisualSVN来，未修改）:
/* Style sheet for displaying the Subversion directory listing
that is generated by mod_dav_svn and "svnindex.xsl". */
body{
font-family:Verdana, Arial, Helvetica, sans-serif;
font-size:9pt;
background: #ffffff;
margin: 0;
padding: 0;
}
img { border: none; }
a {
color: navy;
}
.header
{
text-align: right;
margin-right: 0.5em;
clear: both;
margin-left: 0.5em;
background: url(header.png) top left no-repeat;
height: 48px;
padding: 6px;
}
.footer {
text-align: right;
margin-top: 1em;
padding: 0.5em 1em 0.5em;
font-size: 80%;
}
.svn {
margin-left: 0.5em;
margin-right: 0.5em;
}
.rev {
margin-right: 3px;
padding-left: 3px;
text-align: left;
font-size: 120%;
}
.dir a {
text-decoration: none;
color: black;
display: block;
}
.dir img { vertical-align: middle }
.file a {
text-decoration: none;
color: black;
display: block;
}
.file {
margin: 3px;
padding: 3px;
background: rgb(95%,95%,95%);
}
.file img { vertical-align: middle }
.file:hover {
margin: 3px;
padding: 3px;
background: rgb(90%,100%,90%);
}
.dir {
margin: 3px;
padding: 3px;
background: rgb(90%,90%,90%);
}
.dir:hover {
margin: 3px;
padding: 3px;
background: rgb(80%,100%,80%);
}
还有文件/svn/bin/httpd/htdocs/svnAuth.js（从VisualSVN来，增加txt = txt.replace(/[\n]/ig, '')语句，增加"&type=CHG"和"&type=NEW"两条语句）:
var svnpassURL="/cgi-bin/svnpass.py";
String.prototype.encodeURI=function() {var rS; rS=escape(this); return rS.replace(/\+/g,"%2B");};
function doChange()
{
if (document.getElementById("creatInfo")) $("#creatInfo").remove();
if (!document.getElementById("pwInfo"))
{
$(' '
+'用户名： '
+'密 码： '
+'新密码： '
+'新密码确认： '
+' '
+' '
+'').insertBefore("#header");
$("#btnSubmit").bind("click", execChange);
$("#btnCancel").bind("click", function() { $("#pwInfo").remove(); } );
}
}
function execChange()
{
var u=function(txt)
{
txt = txt.replace(/[\n]/ig, '')
if (txt=="0")
{
alert("操作成功！");
$("#pwInfo").remove();
}
else
{
alert(txt);
$("#btnSubmit").attr("value", "确认修改").removeAttr("disabled");
}
};
$("#btnSubmit").attr("value", "请稍等...").attr("disabled","disabled");
jQuery.post(svnpassURL,
"username="+$("#username").val().encodeURI()
+"&oldpwd="+$("#oldpwd").val().encodeURI()
+"&newpwd="+$("#newpwd").val().encodeURI()
+"&newpwdcfm="+$("#newpwdCfm").val().encodeURI()
+"&type=CHG",
u)
}
function doCreate()
{
if (document.getElementById("pwInfo")) $("#pwInfo").remove();
if (!document.getElementById("creatInfo"))
{
$(' '
+'用户名： '
+'登录密码： '
+'密码确认： '
+' '
+' '
+'').insertBefore("#header");
$("#btnApply").bind("click", execCreat);
$("#btnApplyCancel").bind("click", function() { $("#creatInfo").remove(); } );
}
}
function execCreat()
{
var u=function(txt)
{
txt = txt.replace(/[\n]/ig, '')
if (txt=="0")
{
alert("操作成功！");
$("#creatInfo").remove();
}
else
{
alert(txt);
$("#btnApply").attr("value", "确认申请").removeAttr("disabled");
}
};
$("#btnApply").attr("value", "请稍等...").attr("disabled","disabled");
jQuery.post(svnpassURL,
"username="+$("#usernameApply").val().encodeURI()
+"&pwd="+$("#pwd").val().encodeURI()
+"&pwdcfm="+$("#pwdCfm").val().encodeURI(),
+"&type=NEW",
u)
}
$(document).bind('ready',function(){
if (document.location.href.toLowerCase().indexOf("/svnauth/")!=-1)
{
$("#lnkModify").before('创建新用户 ');
}
});
当然，除了这3个文件外，还有图片，请读者自行添加即可。
至此，web浏览器访问出来的效果就很好看了。但还无法进行web端修改密码。
5.实现客户端修改口令
本人在网上找了很多，大部分是PHP的脚本，还需要安装PHP，感觉并不太方便，也没有解释原理，本人实现效果如下：
现整理下实现原理如下：
- WEB端弹出的密码框由上面的svnAuth.js动态控制
- 真正实现修改口令的是cgi脚本，本文直接使用python提供
因此，本人就偷懒了下，直接把VisualSVN的前端页面（如上述的css和js文件）拿过来了，这样就不用重复造轮子了。
但由于VisualSVN执行的cgi程序svnpass为二进制文件，无法直接放到linux上执行，所以就放弃了。
这里得说下，网上大多使用的是apache2xPasswd和apache2xPasswd.ini文件作为cgi的后台支持。但本人找了下，好像还没有apache24Passwd的文件，而且这还是二进制的文件，太方便修改了。所以本人还是自己动手吧，最终发现其实并不复杂。
现直接亮出python脚本：/svn/bin/httpd/cgi-bin/svnpass.py：
#!/usr/bin/python
#-*- coding: UTF-8
import os
import cgi
import subprocess
pwdfile = "/svndata/Repositories/svn_conf/htpasswd"
cmdfile = "/svn/bin/httpd/bin/htpasswd"
errmsg = ""
def run_script(c):
try :
res = subprocess.check_output(c, shell=True)
return True
except Exception as exp:
errmsg = exp.output
return False
def check(n, p):
cmd = "%s -bv %s %s %s" % (cmdfile, pwdfile, n, p)
#print "check: ", cmd
return run_script(cmd)
def setPwd(n, p):
cmd = "%s -D %s %s;%s -b %s %s %s" % (cmdfile, pwdfile, n, cmdfile, pwdfile, n, p)
return run_script(cmd)
def main():
print "Content-type: text/html; charset=utf-8\n"
form = cgi.FieldStorage()
name = form.getvalue("username" , "").strip()
optype = form.getvalue("type" , "").strip()
## create
pwd = form.getvalue("pwd" , "").strip()
pwdcfm = form.getvalue("pwdcfm" , "").strip()
## change
oldpwd = form.getvalue("oldpwd" , "").strip()
newpwd1 = form.getvalue("newpwd" , "").strip()
newpwd2 = form.getvalue("newpwdcfm", "").strip()
if name == "" or optype == "" :
print "缺少参数用户名或者类型"
return
## create
if optype == "NEW" :
if pwd == "" or pwdcfm == "" or pwd != pwdcfm :
print "密码不能为空或两次密码输入不一致！"
else :
print ("0" if setPwd(name, pwd) else "设置密码失败：" + errmsg)
elif optype == "CHG" :
if oldpwd == "" or newpwd1 == "" or newpwd2 == "" or newpwd1 != newpwd2 :
print "密码不能为空或两次密码输入不一致！"
else :
if not check(name, oldpwd) :
print "原始密码验证失败"
else :
print ("0" if setPwd(name, newpwd1) else "修改密码失败：" + errmsg)
else :
print "类型不正确！"
## for key in os.environ.keys():
## print "%s = %s
" % (key, os.environ[key])
main()
此脚本就是当前端svnAuth.js执行jquery.post()方法时，异步的返回是否修改口令成功，如果返回"0"，表示成功，返回其它字符表示出错了。当然这种前后台接口是最low的，但对于svn这种工具，也没有必要花心思去设计那么完美的接口，比如什么json、restfull之类的东东。
总结起来核心点是：
- 使用/svn/bin/httpd/bin/htpasswd命令行工具进行验证、修改用户口令
那么也就是说大家熟悉哪门语言或者说linux服务器上支持哪门语言，就可以直接写这样类似的脚本。本人当前机器刚好已经自带了python2.7，所以就直接用python去写了。
然后设置一下svnpass.py的执行权限为+x。
至此，所有的配置就已经完成了。
经过这快2周的调试，总算弄明白这svn通过http方式访问的原理，而且用户能自己修改口令。其实我真希望svn官网能直接提供这种支持，让用户使用起来更加方便。