HUB
Sign inSign up

isul/svngo

By isul

•Updated 20 days ago

Lightweight SVN server: Apache mod_dav_svn + Go web admin UI | 경량 SVN 서버: 웹 관리 UI

Image
0

183

isul/svngo repository overview

⁠SvnGo

English⁠ | 한국어⁠


⁠English

Apache httpd + mod_dav_svn serves Subversion over HTTP/HTTPS, and a Go-based multilingual (English · Korean) web admin UI manages repositories, users, groups, and permissions. Everything runs in a single container.

  • Source, docs, issues: github.com/isul/svngo⁠

  • Image ~36 MB; idle memory ~12 MB (Apache included)

  • Changes to repositories, users, or permissions do not require an Apache restart

  • Can run as non-root (uid 1000), read-only root filesystem, cap_drop: ALL

  • No external database (SQLite built in)

⁠Features
AreaFeatures
RepositoriesCreate (trunk/branches/tags), rename, delete, enable/disable, verify (svnadmin verify), backup (dump.gz) and restore
Web browsingDirectory/file views, view at revision, download, commit log, changed files, diff. SVN permissions on every screen
Users & groupsCreate, edit, delete, change password, enable/disable, import htpasswd (bcrypt / APR1-MD5)
PermissionsRead / read-write / no access per repository and directory. After save, effective rules are verified with libsvn
OperationsDashboard, audit log, application and Apache logs, auth file sync verification
SecuritySeparate allowlists for admin UI and SVN, SVN brute-force IP blocking (429), web login rate limits, CSRF hardening, strict CSP, request size limits
LanguagesEnglish and Korean built in, browser language detection, per-user language, system default, add languages via JSON upload or /data/config/locales/
⁠Quick start
⁠docker run
docker run -d --name svngo --restart unless-stopped \
  -p 80:8080 -p 443:8443 \
  -e ADMIN_PASSWORD='Change-Me-123' \
  -v svn-repos:/data/repos -v svn-config:/data/config \
  -v svn-db:/data/db -v svn-backups:/data/backups \
  --read-only \
  --tmpfs /run/svngo:size=16m,mode=0750,uid=1000,gid=1000 \
  --tmpfs /tmp:size=64m,mode=1777 \
  --cap-drop ALL \
  isul/svngo:1.0.0

On Windows PowerShell, use backticks (`) instead of \ for line continuation, or put the command on one line.

⁠docker compose
services:
  svngo:
    image: isul/svngo:1.0.0
    container_name: svngo
    restart: unless-stopped
    ports:
      - "80:8080"
      - "443:8443"
    environment:
      ADMIN_USERNAME: admin
      ADMIN_PASSWORD: Change-Me-123   # 8+ chars; used only on first start
      SVNGO_SERVER_NAME: svn.example.com
      TZ: Asia/Seoul
    volumes:
      - svn-repos:/data/repos
      - svn-config:/data/config
      - svn-db:/data/db
      - svn-backups:/data/backups
    read_only: true
    tmpfs:
      - /run/svngo:size=16m,mode=0750,uid=1000,gid=1000
      - /tmp:size=64m,mode=1777
    cap_drop:
      - ALL
    security_opt:
      - no-new-privileges:true
    stop_grace_period: 30s

volumes:
  svn-repos:
  svn-config:
  svn-db:
  svn-backups:
docker compose up -d
docker compose ps        # STATUS healthy = ready
⁠Access
PurposeURL
Web admin UIhttp://<host>/admin/
SVN repositorieshttp://<host>/svn/<repo-name>
Health checkhttp://<host>/admin/healthz
svn checkout http://<host>/svn/myrepo/trunk myrepo --username kim

In TortoiseSVN, use http://<host>/svn/myrepo as the repository URL.

⁠Initial admin account
  • On first start, if no admin exists, one is created from ADMIN_USERNAME (default admin) and ADMIN_PASSWORD (minimum 8 characters).

  • If ADMIN_PASSWORD is empty, a random password is written to /data/config/initial-admin-password (not printed in logs).

    docker exec svngo cat /data/config/initial-admin-password
    
  • If you forgot the password:

    echo 'New-Admin-Pass-123' | docker exec -i svngo svngo admin-passwd admin
    
⁠Environment variables
VariableDefaultDescription
ADMIN_USERNAMEadminInitial admin username
ADMIN_PASSWORD / ADMIN_PASSWORD_FILE(none)Initial admin password (8+ chars). File path supported (Docker secret)
SVNGO_SERVER_NAMElocalhostApache ServerName
SVNGO_COOKIE_SECUREautoSession cookie Secure: auto (HTTPS or X-Forwarded-Proto: https) / always / never
SVNGO_BCRYPT_COST8SVN user bcrypt cost (5–14). Higher values slow SVN auth
SVNGO_SESSION_HOURS12Web session lifetime
SVNGO_SVN_MAX_BODY_MB1024Max size per SVN request (effectively per file), MB. 0 = unlimited, max 2047
SVNGO_SVN_MAX_XML_MB64Max SVN XML body size, MB. 0 = unlimited
SVNGO_ADMIN_ALLOW_IPS(none)Always-allow IP/CIDR for /admin (comma-separated). Merged with UI list
SVNGO_SVN_ALLOW_IPS(none)Always-allow IP/CIDR for /svn. Apache returns 403 before auth
SVNGO_TLS_CERT / SVNGO_TLS_KEY/data/config/tls/server.crt / .keyEnables HTTPS on 8443 when both files exist
TZAsia/SeoulDisplay timezone
⁠Ports and volumes
ItemDescription
8080HTTP (SVN + web admin)
8443HTTPS (when certificates are present)
/data/reposSVN repositories
/data/confightpasswd, authz (auto-generated), tls/ certs, locales/ extra languages
/data/dbSQLite (users, groups, permissions, audit log)
/data/backupsRepository backups (.svndump.gz)

Back up all four volumes for a full backup. With bind mounts, set directory owner to uid/gid 1000. Otherwise startup fails with directory ... is not writable ... permission denied.

⁠Read-only root filesystem (read_only / --read-only)

read_only: true mounts the image root read-only for hardening. Writable paths:

PathTypePurpose
/data/* (four volumes)volume / bindPersistent data
/run/svngotmpfsApache PID, SVN login block list, svn client config
/tmptmpfsTemporary files
  • With read-only root, both tmpfs mounts are required (/run/svngo with uid=1000,gid=1000). Without them Apache will not start.
  • tmpfs contents are cleared on restart and recreated on boot.
  • With read_only: false, behavior is the same except this layer of protection is removed.
⁠Synology NAS

Runs on DSM 7.2+ Container Manager. Published Hub images are linux/amd64 (Intel/AMD Synology models).

1. Prepare data folders (required). DSM shared folders often use ACLs that block uid 1000. Over SSH (Control Panel → Terminal & SNMP), remove ACLs and fix ownership:

BASE=/volume1/docker/svngo
for d in repos config db backups; do
  sudo mkdir -p "$BASE/$d"
  sudo find "$BASE/$d" -exec /usr/syno/bin/synoacltool -del {} \; >/dev/null 2>&1
  sudo chown -R 1000:1000 "$BASE/$d"
  sudo chmod -R u+rwX,g+rX,o-rwx "$BASE/$d"
done
ls -ln "$BASE"   # all four folders should show 1000 1000

2. Create a project. In Container Manager → Project → Create, paste the compose example above and adjust:

    ports:
      - "36900:8080"
      - "36901:8443"
    volumes:
      - /volume1/docker/svngo/repos:/data/repos
      - /volume1/docker/svngo/config:/data/config
      - /volume1/docker/svngo/db:/data/db
      - /volume1/docker/svngo/backups:/data/backups

Remove the bottom volumes: named-volume block. Web UI: http://<NAS>:36900/admin/.

3. HTTPS. Copy DSM certs to $BASE/config/tls/server.crt and server.key, chown to uid 1000, restart — HTTPS on 36901. Prefer direct HTTPS for SVN clients. Terminating TLS only at DSM reverse proxy and forwarding HTTP can break svn copy (branches/tags) and svn move with 502 Bad Gateway.

More detail: Synology section in README.ko.md⁠ (Korean).

⁠HTTPS
  • Inside the container: Place PEM cert and key at tls/server.crt and tls/server.key on the config volume, restart — HTTPS on 8443, HSTS and Secure cookies.
  • Reverse proxy: Terminate TLS with Nginx, Traefik, Caddy, etc., proxy to http://<container>:8080. Send X-Forwarded-Proto: https or set SVNGO_COOKIE_SECURE=always.
⁠Migrating from an existing SVN server
  1. Copy repository directories to /data/repos — auto-registered on start or via System settings → Scan repositories. Upload svnadmin dump files on the Backups screen to restore.
  2. Import existing htpasswd via Users → Import htpasswd (bcrypt, APR1-MD5).
  3. Re-create groups and permissions in the web UI. Do not edit authz by hand — it is generated from the DB.
⁠IP allowlists

System settings → Access restriction (allowed IPs) configures separate lists for the admin UI and SVN. Applied without restart; env vars above are always merged in. Empty lists mean no restriction; loopback is always allowed. If locked out:

docker exec svngo svngo access-reset admin   # admin | svn | all
⁠Notes
  • No svn:// (svnserve) — HTTP/HTTPS only. Authentication: htpasswd (Basic) only.
  • SVN login blocking is per IP. If all clients appear as one IP (some Docker Desktop setups, proxies), raise limits or disable under System settings.
  • On some Linux hosts (AppArmor, snap Docker), no-new-privileges may cause operation not permitted — remove that security_opt if needed.
⁠Tags
TagDescription
1.0.0, latestlinux/amd64

Stack: Alpine 3.22, Apache 2.4, Subversion 1.14, Go 1.26


⁠한국어

Apache httpd + mod_dav_svn으로 SVN(HTTP/HTTPS)을 서비스하고, Go로 만든 다국어(영어·한국어) 웹 관리 UI로 저장소·사용자·그룹·권한을 관리하는 경량 Subversion 서버입니다. 모든 구성 요소가 컨테이너 하나에 들어 있습니다.

  • 소스 코드, 상세 문서, 이슈: github.com/isul/svngo⁠

  • 이미지 약 36MB, 유휴 메모리 약 12MB(Apache 포함)

  • 저장소·사용자·권한을 바꿔도 Apache 재시작이 필요 없습니다

  • non-root(uid 1000), 읽기 전용 루트 파일시스템, cap_drop: ALL로 실행할 수 있습니다

  • 외부 DB 불필요(SQLite 내장)

⁠주요 기능
영역기능
저장소생성(trunk/branches/tags), 이름 변경, 삭제, 활성/비활성, 검증(svnadmin verify), 백업(dump.gz)·복원
웹 브라우징디렉터리/파일 보기, 리비전별 보기, 다운로드, 커밋 로그, 변경 파일, diff. 모든 화면에 SVN 권한 적용
사용자·그룹생성, 수정, 삭제, 비밀번호 변경, 활성/비활성, htpasswd 가져오기(bcrypt / APR1-MD5)
권한저장소·디렉터리 단위 읽기 / 읽기쓰기 / 접근 금지. 저장 후 libsvn으로 실제 적용 결과를 검증
운영대시보드, 감사 로그, 애플리케이션·Apache 로그, 인증 파일 동기화 검증
보안관리 UI·SVN 각각의 접근 허용 IP 목록, SVN 무차별 대입 IP 차단(429), 웹 로그인 시도 제한, 다중 CSRF 방어, 엄격한 CSP, 요청 크기 제한
다국어영어·한국어 기본 제공, 브라우저 언어 자동 선택, 사용자별 언어 고정, 시스템 기본 언어, 언어 파일(JSON) 업로드 또는 /data/config/locales/ 폴더로 언어 추가
⁠빠른 시작
⁠docker run
docker run -d --name svngo --restart unless-stopped \
  -p 80:8080 -p 443:8443 \
  -e ADMIN_PASSWORD='Change-Me-123' \
  -v svn-repos:/data/repos -v svn-config:/data/config \
  -v svn-db:/data/db -v svn-backups:/data/backups \
  --read-only \
  --tmpfs /run/svngo:size=16m,mode=0750,uid=1000,gid=1000 \
  --tmpfs /tmp:size=64m,mode=1777 \
  --cap-drop ALL \
  isul/svngo:1.0.0

Windows PowerShell에서는 줄 끝의 \ 대신 백틱(`)을 쓰거나 한 줄로 입력합니다.

⁠docker compose
services:
  svngo:
    image: isul/svngo:1.0.0
    container_name: svngo
    restart: unless-stopped
    ports:
      - "80:8080"
      - "443:8443"
    environment:
      ADMIN_USERNAME: admin
      ADMIN_PASSWORD: Change-Me-123   # 8자 이상, 최초 실행 시에만 사용됩니다
      SVNGO_SERVER_NAME: svn.example.com
      TZ: Asia/Seoul
    volumes:
      - svn-repos:/data/repos
      - svn-config:/data/config
      - svn-db:/data/db
      - svn-backups:/data/backups
    read_only: true
    tmpfs:
      - /run/svngo:size=16m,mode=0750,uid=1000,gid=1000
      - /tmp:size=64m,mode=1777
    cap_drop:
      - ALL
    security_opt:
      - no-new-privileges:true
    stop_grace_period: 30s

volumes:
  svn-repos:
  svn-config:
  svn-db:
  svn-backups:
docker compose up -d
docker compose ps        # STATUS 가 healthy 이면 준비 완료
⁠접속
용도URL
웹 관리 UIhttp://<서버>/admin/
SVN 저장소http://<서버>/svn/<저장소명>
헬스체크http://<서버>/admin/healthz
svn checkout http://<서버>/svn/myrepo/trunk myrepo --username kim

TortoiseSVN에서는 저장소 URL로 http://<서버>/svn/myrepo를 입력합니다.

⁠초기 관리자 계정
  • 처음 시작할 때 관리자 계정이 없으면 ADMIN_USERNAME(기본 admin) / ADMIN_PASSWORD로 만듭니다. 비밀번호는 8자 이상이어야 합니다.

  • ADMIN_PASSWORD를 비워 두면 임의 비밀번호를 만들어 /data/config/initial-admin-password에 저장합니다(로그에는 출력하지 않음).

    docker exec svngo cat /data/config/initial-admin-password
    
  • 비밀번호를 잊었을 때:

    echo 'New-Admin-Pass-123' | docker exec -i svngo svngo admin-passwd admin
    
⁠환경 변수
변수기본값설명
ADMIN_USERNAMEadmin초기 관리자 ID
ADMIN_PASSWORD / ADMIN_PASSWORD_FILE(없음)초기 관리자 비밀번호(8자 이상). 파일 경로로도 지정 가능(Docker secret)
SVNGO_SERVER_NAMElocalhostApache ServerName
SVNGO_COOKIE_SECUREauto세션 쿠키 Secure: auto(HTTPS 또는 X-Forwarded-Proto: https) / always / never
SVNGO_BCRYPT_COST8SVN 사용자 bcrypt cost(5–14). 높을수록 SVN 요청이 느려집니다
SVNGO_SESSION_HOURS12웹 세션 유효 시간
SVNGO_SVN_MAX_BODY_MB1024SVN 요청 하나(사실상 파일 하나)의 최대 크기, MB. 0=무제한, 최대 2047
SVNGO_SVN_MAX_XML_MB64SVN XML 요청 최대 크기, MB. 0=무제한
SVNGO_ADMIN_ALLOW_IPS(없음)관리 UI(/admin)에 항상 허용할 IP/CIDR(쉼표 구분). 웹 UI 목록과 합쳐 적용
SVNGO_SVN_ALLOW_IPS(없음)SVN(/svn)에 항상 허용할 IP/CIDR. Apache가 인증 전에 403으로 거부
SVNGO_TLS_CERT / SVNGO_TLS_KEY/data/config/tls/server.crt / .key두 파일이 있으면 8443에서 HTTPS 활성화
TZAsia/Seoul표시 시간대
⁠포트와 볼륨
항목설명
8080HTTP (SVN + 웹 관리 UI)
8443HTTPS (인증서가 있을 때)
/data/reposSVN 저장소
/data/confightpasswd, authz(자동 생성), tls/ 인증서, locales/ 추가 언어 파일
/data/dbSQLite DB(사용자·그룹·권한·감사 로그)
/data/backups저장소 백업(.svndump.gz)

네 볼륨을 함께 보관하면 전체 백업이 됩니다. 바인드 마운트를 쓸 때는 디렉터리 소유자를 uid/gid 1000으로 맞춰 주세요. 맞지 않으면 directory ... is not writable ... permission denied 오류로 시작하지 않습니다.

⁠읽기 전용 루트 파일시스템 (read_only / --read-only)

예제의 read_only: true는 이미지 내용을 읽기 전용으로 마운트하는 보안 옵션입니다. 컨테이너 안에서 코드가 실행되더라도 실행 파일이나 설정을 바꿀 수 없습니다. 쓰기는 다음 경로에서만 일어납니다.

경로종류용도
/data/* 네 볼륨볼륨 / 바인드 마운트영구 데이터
/run/svngotmpfsApache PID 파일, SVN 로그인 차단 목록, svn 클라이언트 설정 등 런타임 파일
/tmptmpfs임시 파일
  • 읽기 전용으로 실행할 때는 tmpfs 두 항목(/run/svngo는 uid=1000,gid=1000)이 꼭 있어야 합니다. 없으면 Apache가 시작하지 못합니다.
  • tmpfs 내용은 재시작하면 지워지지만 시작할 때 다시 만들어집니다.
  • read_only: false여도 기능은 같고, 보호 장치 하나가 빠질 뿐입니다.
⁠시놀로지(Synology) NAS

DSM 7.2 이상의 Container Manager에서 실행할 수 있습니다. 이미지가 linux/amd64 전용이라 Intel/AMD CPU 모델만 지원합니다.

1. 데이터 폴더 준비 (필수). DSM 공유 폴더는 소유자가 DSM 사용자이고 ACL이 걸려 있어 uid 1000인 컨테이너가 쓸 수 없습니다. SSH로 접속해 ACL을 제거하고 소유자를 바꿉니다(SSH는 제어판 → 터미널 및 SNMP에서 켭니다).

BASE=/volume1/docker/svngo
for d in repos config db backups; do
  sudo mkdir -p "$BASE/$d"
  sudo find "$BASE/$d" -exec /usr/syno/bin/synoacltool -del {} \; >/dev/null 2>&1
  sudo chown -R 1000:1000 "$BASE/$d"
  sudo chmod -R u+rwX,g+rX,o-rwx "$BASE/$d"
done
ls -ln "$BASE"   # 네 폴더 모두 1000 1000 이면 정상

2. 프로젝트 만들기. Container Manager → 프로젝트 → 생성에서 위 compose 예제를 붙여 넣고 다음 부분만 바꿉니다. DSM이 80/443을 쓰므로 다른 호스트 포트를 사용합니다.

    ports:
      - "36900:8080"
      - "36901:8443"
    volumes:
      - /volume1/docker/svngo/repos:/data/repos
      - /volume1/docker/svngo/config:/data/config
      - /volume1/docker/svngo/db:/data/db
      - /volume1/docker/svngo/backups:/data/backups

맨 아래의 volumes: 블록(named volume 선언)은 지웁니다. 웹 UI는 http://<NAS주소>:36900/admin/입니다.

3. HTTPS. DSM 인증서(/usr/syno/etc/certificate/_archive/<ID>/fullchain.pem, privkey.pem)를 $BASE/config/tls/server.crt, server.key로 복사하고 uid 1000 소유로 바꾼 뒤 재시작하면 36901에서 HTTPS가 켜집니다. SVN은 이 포트로 직접 접속하세요. DSM 역방향 프록시에서 TLS를 종료하고 HTTP로 넘기면 브랜치·태그 생성(svn copy)과 svn move가 502 Bad Gateway로 실패할 수 있습니다.

자세한 절차(인증서 자동 갱신, 운영 팁)는 GitHub README의 "시놀로지(Synology) NAS에서 실행하기"⁠를 참고하세요.

⁠HTTPS
  • 컨테이너에서 직접: PEM 인증서와 키를 config 볼륨의 tls/server.crt, tls/server.key로 넣고 재시작하면 8443에서 HTTPS가 켜지고 HSTS와 Secure 쿠키가 적용됩니다.
  • 리버스 프록시: Nginx, Traefik, Caddy 등에서 TLS를 종료하고 http://<컨테이너>:8080으로 전달합니다. X-Forwarded-Proto: https를 보내거나 SVNGO_COOKIE_SECURE=always를 지정하세요.
⁠기존 SVN 서버에서 이전
  1. 저장소 디렉터리를 /data/repos에 복사하면 시작할 때(또는 시스템 설정 → 저장소 스캔) 자동 등록됩니다. svnadmin dump 파일은 백업 화면에서 업로드해 복원할 수 있습니다.
  2. 기존 htpasswd는 사용자 → htpasswd 가져오기로 옮깁니다(bcrypt, APR1-MD5 지원).
  3. 그룹과 권한은 웹 UI에서 다시 설정합니다. authz 파일은 DB에서 자동 생성되므로 직접 수정하지 마세요.
⁠접근 IP 제한

**시스템 설정 → 접근 제한 (허용 IP)**에서 관리 UI와 SVN에 접근할 수 있는 IP/CIDR을 각각 정합니다. 재시작 없이 바로 적용되고, 위 환경 변수 항목은 항상 함께 허용됩니다. 목록이 모두 비어 있으면 제한하지 않으며, 루프백은 항상 허용합니다. 잠겼을 때는 다음 명령으로 웹 UI 목록을 지웁니다.

docker exec svngo svngo access-reset admin   # admin | svn | all
⁠참고
  • svn://(svnserve)는 지원하지 않고 HTTP/HTTPS만 지원합니다. 인증은 htpasswd(Basic)만 지원합니다.
  • SVN 로그인 차단은 IP 기준입니다. 모든 클라이언트가 같은 IP로 보이는 환경(일부 Docker Desktop, 프록시 뒤)에서는 시스템 설정에서 허용 횟수를 높이거나 0으로 꺼 주세요.
  • 일부 Linux 호스트(AppArmor, snap Docker)에서 no-new-privileges 때문에 operation not permitted가 나면 해당 security_opt를 제거하세요.
⁠태그
태그설명
1.0.0, latestlinux/amd64

구성: Alpine 3.22, Apache 2.4, Subversion 1.14, Go 1.26

Tag summary

Content type

Image

Digest

sha256:17518e1f6…

Size

14.7 MB

Last updated

20 days ago

docker pull isul/svngo