{"id":224,"date":"2017-11-30T17:40:18","date_gmt":"2017-11-30T16:40:18","guid":{"rendered":"https:\/\/borck-online.com\/?p=224"},"modified":"2017-12-15T19:45:48","modified_gmt":"2017-12-15T18:45:48","slug":"synology-git-server-aufsetzen","status":"publish","type":"post","link":"https:\/\/borck-online.com\/?p=224","title":{"rendered":"Synology Git-Server f\u00fcr Windows Benutzer"},"content":{"rendered":"

Ein Synology Network Attached Storage (NAS) bietet neben der M\u00f6glichkeit einer eigenen Cloud auch die M\u00f6glichkeit eines eigenen Git-Servers. Dieser Artikel hilft ein wenig \u00fcber die dabei auftretenden Schwierigkeiten hinweg, speziell wenn man auf einem Windows System arbeitet und Git mit einem SSH Zertifikat benutzen will. Warum das SSH wichtig ist, erkl\u00e4rt sich sp\u00e4ter von selbst.<\/h3>\n

Schritt 1 – Git auf der Synology installieren und Benutzer konfigurieren<\/h3>\n

Nachdem man \u00fcber das Paketzentrum<\/strong><\/em> den Git-Server installiert hat, w\u00e4hlt man im Hauptmen\u00fc<\/strong><\/em> das neue Symbol aus und klickt es an. Ein spartanischer Dialog geht auf, der nur dazu dient, die Benutzer auszuw\u00e4hlen, die den Git-Server benutzen d\u00fcrfen. Man klickt also die Zugriffserlaubnis des jeweiligen Benutzers [benutzername]<\/strong> <\/em>an und beendet dann mit \u00dcbernehmen<\/strong><\/em>.<\/h5>\n

\"\"<\/a><\/p>\n

Die Git-Benutzer m\u00fcssen in die Administrator<\/strong><\/em> Gruppe eingetragen werden. Dies erledigt man \u00fcber die Synology Systemsteuerung\\Benutzer<\/strong><\/em>. Den Benutzer ausw\u00e4hlen, Bearbeiten<\/strong><\/em> und unter Benutzergruppe<\/strong><\/em>n den Haken bei administrators<\/strong><\/em> setzen.<\/h5>\n

\"\"<\/a><\/p>\n

Schritt 2 – Synology WebDAV aktivieren<\/h3>\n
WebDAV muss aktiviert sein. In der Synology Systemsteuerung auf Dateidienste klicken und zun\u00e4chst den Windows Dateidienst aktivieren und \u00dcbernehmen<\/strong><\/em>. Im Top-Men\u00fc oben dann rechts auf WebDAV gehen und dann unten wieder den WebDAV aktivieren und \u00dcbernehmen<\/strong><\/em>.<\/h5>\n

\"\"<\/a><\/p>\n

Schritt 3 – Synology SSH aktivieren<\/h3>\n
SSH Zugriff sollte aktiviert sein. Hierzu in der Synology Systemsteuerung auf Terminal & SNMP klicken und den SSH-Dienst aktivieren. SSH erm\u00f6glicht eine zertifikat-basierte Nutzung, dazu jedoch erst sp\u00e4ter noch mehr.<\/h5>\n

\"\"<\/a><\/p>\n

Schritt 4 – Repository-Ordner anlegen, Git dort initialisieren und danach Ordner-Rechte vergeben<\/h3>\n
Erstellen eines gemeinsamen Ordners auf der Synology, welcher die Repositories hostet. Hierf\u00fcr kann die File Station oder die Systemsteuerung der Synology (Gemeinsamer Ordner) benutzt werden. Besser ist jedoch die Kommandozeile von Windows aus. Hierzu nimmt man einen SSH-tauglichen Shell Client wie z.B. Putty verbindet mit sich per SSH auf Port 22 mit der IP-Adresse der Synology (Benutzer: root mit admin passwort benutzen) und landet in root’s home Verzeichnis. Wir wechsel eine Ebene hoch und schauen uns mit dem Kommando ll<\/strong> <\/em>die Directory Struktur an. Wir wechseln dann in den Ordner, wo die gemeinsamen Ordner und die home-Verzeichnisse liegen. Typischerweise heisst der Ordner volume1<\/strong><\/em>. Hier legen wir jetzt einen Ordner names git<\/strong> <\/em>an. Wir wechseln in den neuen Ordner und legen dort mal einen Projekt-Ordner an (z.B. mkdir project_1<\/strong><\/em>). Wir wechseln in den Ordner und f\u00fchren zun\u00e4chst ein git init –bare –shared<\/strong><\/em> aus. Danach noch ein git update-server-info<\/strong><\/em>. Ein ll<\/strong><\/em> zeigt uns nun ein von Git erstelltes Repository. Wir springen jetzt wieder 2 Ordner Ebenen zur\u00fcck, um wieder den git Ordner zu sehen. Nun m\u00fcssen wir die Rechte, Eigent\u00fcmer und Gruppe des git Ordners setzen, und das rekursiv f\u00fcr alle darin liegenden Verzeichnisse, also auch unser erstes Repository.<\/h5>\n
cd ..\r\ncd volume1\r\nmkdir git\r\ncd git\r\nmkdir project_1\r\ncd project_1\r\ngit init --bare --shared\r\ngit update-server-info\r\ncd ..\r\ncd ..\r\nchmod -R 772 git\r\nchown -R admin git\r\nchgrp -R administrators git<\/pre>\n
Jetzt k\u00f6nnen sp\u00e4ter alle zugelassenen User der Synology den Repository-Ordner project_1<\/strong><\/em> schreiben, typischerweise von Windows aus mit Hilfe des Git Kommandos. F\u00fcr weitere, zuk\u00fcnftige Repositories (Ordner) ist dann analog zu verfahren, d.h. das initiale Erzeugen erfolgt immer hier auf der Synology und unter Windows wird nur geclont. Die putty-Shell kann offen bleiben, wir brauchen sie sp\u00e4ter noch.<\/h5>\n
Schritt 5 – Git unter Windows installieren, Umgebungsvariable setzen, Git-Bash-Link Eigenschaften festlegen<\/h3>\n
Als n\u00e4chstes installiert man Git unter Windows, am besten mit allen Default-Einstellungen w\u00e4hrend der Installation. Zum Anfang und zum Testen empfiehlt sich die mitgelieferte Git-Bash. Sie liegt nach der Installation als Verkn\u00fcpfung auf dem Desktop. Wir gehen im Folgenden mal davon aus, dass unsere lokalen Projekte (auf dem Windows Rechner) im Verzeichnis d:\\projekte\\git\\<\/strong><\/em> liegen sollen. Mit lokalem Projekt ist jeweils ein geclontes Git Projekt (Repository) von der Synology gemeint. Gegebenenfalls kann man noch die Git-Extensions installieren. Das ist ein kostenloses, grafisches Benutzer Interface (GUI) f\u00fcr Git. Die Extensions arbeiten mit der Umgebungsvariable HOME<\/strong><\/em>, weshalb wir diese gleich in den Erweiterten Systemeigenschaften\\Umgebungsvariablen<\/strong><\/em> wie folgt setzen: HOME=d:\\projekte\\git<\/strong><\/em>. Wir k\u00f6nnen diese Systemvariable auch gleich benutzen, um unsere Git-Bash gleich im richtigen Verzeichnis zu starten. Dazu \u00e4ndern wir die Eigenschaft Ausf\u00fchren in<\/strong><\/em> der Git-Bash Verk\u00fcpfung zu %HOME%<\/strong><\/em>. Der Doppelklick startet die Git-Bash nun gleich im gew\u00fcnschten Verzeichnis der lokalen Git-Repositories. Die sind ja aber noch nicht da. Wir m\u00fcssen erstmal eins clonen, n\u00e4mlich jenes, welches wir in Schritt 4 schon auf der Synology angelegt haben.<\/h5>\n
\"\"<\/a><\/p>\n
\"\"<\/a><\/h3>\n
Schritt 6 – Git Repository unter Windows clonen<\/h3>\n
Wir geben in der Git-Bash ein: git clone ssh:\/\/benutzername@IP-Adresse_Synology\/volume1\/git\/project_1<\/strong><\/em>. Verdammt … der Ziel-Server ist scheinbar nicht SSH vertrauenw\u00fcrdig und faselt was von Fingerprint. Wir sagen yes<\/strong> <\/em>und … Mist, Synology will jetzt nat\u00fcrlich das Passwort f\u00fcr den Benutzer benutzername<\/strong><\/em>. Wir geben es ein und dr\u00fccken Enter<\/strong><\/em>. Git sollte nun kurz arbeiten und dann mit der Meldung warning: You appear to have cloned an empty repository<\/strong> <\/em>abschliessen. Ein Blick in den Ordner d:\\projekte\\git<\/strong><\/em> sollte dort nun den Ordner project_1<\/strong><\/em> enthalten, das leere, erste geclonte Repository unseres Git-Servers. Prima soweit … Was jetzt aber extrem nervt, ist die Tatsache, dass wir bei jedem Git Befehl nach dem Passwort f\u00fcr die Synology gefragt werden. Abhilfe schafft ein Zertifikat nach dem Public\/Private Key<\/strong><\/em> Verfahren, mit dessen Hilfe sich unser Windows Rechner automatisch bei der SSH Verbindung authentifiziert.<\/h5>\n
git clone ssh:\/\/benutzername@IP-Adresse_Synology\/volume1\/git\/project_1<\/pre>\n
Schritt 7 – Synology Git Zugriff per SSH Zertifikat einrichten<\/h3>\n
Erstellen eines SSH-Zertifikates. Dieser Schritt ist der schwierigste, weil er sehr viel Sorgfalt erfordert. Eine kleine Unachtsamkeit wird immer dazu f\u00fchren, das beim Absetzen eines Git-Kommandos in Richtung Synology mit einer Passwort-Abfrage beginnt, was letztendlich bedeutet, dass dieser Schritt nicht korrekt ausgef\u00fchrt wurde. Ich selbst habe hierf\u00fcr mehrere Stunden recherchiert und war kurz vor der Verzweifelung, bis es dann doch geklappt hat !!<\/h5>\n
Wir gehen zur\u00fcck zur putty-Shell, wechseln auf der Synology in das home-Verzeichnis homes<\/strong> <\/em>aller Benutzer. Per ll<\/strong><\/em> schauen wir uns mal alle home-Verzeichnisse darin an. Jeder Benutzer hat dort einen eigenen Ordner, dessen Rechte auf 755 stehen sollten. Falls nicht, chmod 755 benutzername<\/strong><\/em> tut das dann. Weiterhin sollte der Owner des Ordners der jeweilige benutzername<\/strong><\/em> sein und die Gruppe sollte users<\/strong> <\/em>sein. Falls nicht, tun chown<\/strong><\/em> und chgrp<\/strong><\/em> hier wieder ihren Dienst.<\/h5>\n
cd \\\r\ncd volume1\r\ncd homes<\/pre>\n
\"\"<\/a><\/h5>\n
Wir wechseln nun in den home-Ordner des Benutzers, f\u00fcr den der Git-Server konfiguriert werden soll und geben folgendes Kommando ein: ssh-keygen -t rsa<\/strong><\/em>. Auf die Frage nach Passphrase lassen wir diese leer und auf die Frage nach einem Namen f\u00fcr die Files nehmen wir id_rsa_1<\/strong><\/em>. Es werden 2 Files erzeugt. id_rsa_1<\/strong><\/em> und id_rsa_1.pub<\/strong><\/em>. Das pub-File benennen wir um in authorized_keys<\/strong><\/em>. Dann erzeugen wir per mkdir .ssh<\/strong><\/em> den Ordner .ssh<\/strong><\/em> und verschieben authorized_keys<\/strong> <\/em>dort hinein.<\/p>\n
cd benutzername\r\nssh-keygen -t rsa\r\nmv rsa_1.pub authorized_keys\r\nmkdir .ssh\r\nmv authorized_keys .ssh<\/pre>\n
Wir gehen dann\u00a0 in den Ordner und \u00f6ffnen das File per vi-Editor und springen ans Ende, wo etwas wie root@NameDerSynology<\/strong><\/em> steht. Wir ersetzen root<\/strong> <\/em>durch benutzername<\/strong><\/em> und speichern das File wieder. (wir sind immer noch als root eingeloggt !!)<\/p>\n
\"\"<\/a><\/p>\n
Das File authorized_keys<\/strong><\/em> ben\u00f6tigt die Rechte 600 sowie den Eigent\u00fcmer benutzername<\/strong><\/em> und die Gruppe users<\/strong><\/em>. Wir verlassen .ssh<\/strong><\/em> per cd ..<\/strong><\/em> und pr\u00fcfen per ll<\/strong> <\/em>ob der Ordner .ssh<\/strong> <\/em>die Rechte 700 den Eigent\u00fcmer benutzername<\/strong><\/em> und die Gruppe users<\/strong><\/em> hat. Falls nicht, tun chmode<\/strong><\/em>, chown<\/strong> <\/em>und chgrp<\/strong> <\/em>hier wieder ihren Dienst.<\/h5>\n
\"\"<\/a><\/p>\n
Als n\u00e4chstes m\u00fcssen wir dem SSH der Synology mitteilen, dass es Zertifikate benutzen soll. Dazu gehen wir per cd \/etc\/ssh\/<\/strong><\/em> in den Konfig-Ordner f\u00fcr SSH und modifizieren das File sshd_config<\/strong><\/em> wie folgt. Es m\u00fcssen ggf. 2 Eintr\u00e4ge erschaffen oder nur die Kommentarzeichen am Anfang ihrer Zeilen entfernt werden, damit sie dann so aussehen:<\/h5>\n
PubkeyAuthentication\u00a0\u00a0 yes\r\nAuthorizedKeysFile \u00a0 \u00a0.ssh\/authorized_keys<\/pre>\n
Damit sind wir auf der Synology erstmal fertig.<\/h5>\n
Jetzt brauchen wir das File id_rsa_1<\/strong><\/em> auf dem Windows Host. Dazu benutzen wir am besten WinScp<\/strong><\/em>. Das Programm erlaubt bequemes Navigieren und File-Transfers vom und zum Synology. Wir \u00f6ffnen also eine Verbindung zum Synology (Verwendung von Benutzer root und admin Passwort). Im home-Verzeichnis des Benutzers benutzername<\/strong><\/em> liegt das generierte id_rsa_1<\/strong><\/em>, welches wir nun auf den Windows Rechner verschieben. (File markieren, F6 dr\u00fccken = Herunterladen und L\u00f6schen). Den Speicherort auf dem Windows Rechner merken !! WinScp kann dann wieder geschlossen werden.<\/h5>\n
\"\"<\/a><\/h5>\n
Nun startet man das Programm puttygen.exe<\/strong><\/em> aus dem Putty Programm-Verzeichnis. Wir benennen id_rsa_1<\/strong><\/em> um in id_rsa_1.ppk<\/strong><\/em> und laden es in den Generator. Im Men\u00fc w\u00e4hlen wir nun Conversions\\Export OpenSSH key<\/em><\/strong> aus und speichern das File als id_rsa<\/strong><\/em> ohne Erweiterung ab.<\/h5>\n
\"\"<\/a><\/h5>\n
Nun gehen wir in unseren git Projekt-Ordner d:\\projekte\\git<\/strong><\/em> und erzeugen hier einen Ordner .ssh<\/strong><\/em>. In diesem Ordner legen wir das neue, exportierte id_rsa<\/strong><\/em> File ab. Wir l\u00f6schen nun ein ggf. erstelltes Verzeichnis d:\\projekte\\git\\project_1 <\/strong><\/em>um das Clonen des Repositories erneut testen zu k\u00f6nnen.<\/h5>\n
Und nun kommt der grosse Moment: Zur\u00fcck in die Git-Bash Shell. Dort geben wir wieder git clone ssh:\/\/benutzername@IP-Adresse_Synology\/volume1\/git\/project_1<\/strong><\/em> ein. Wenn jetzt alles richtig konfiguriert ist, sollte keine Passwort-Eingabe mehr erscheinen und die Meldung warning: You appear to have cloned an empty repository.<\/strong> <\/em>sollte ausgegeben werden. Wenn das Repository nicht mehr leer ist, fehlt dieser Hinweis, wie das Beispiel hier zeigt.<\/h5>\n
\"\"<\/a><\/p>\n
Ist dies nicht der Fall, liegt es meistens an falschen Rechten, Owner oder Gruppe der Ordner auf der Synology. Man kann auch nochmal auf dem Windows Host einen Blick in die unter d:\\projekte\\git\\.ssh<\/strong><\/em> abgelegte id_rsa<\/strong><\/em> werfen. Hierin sollte die oberste Zeile so aussehen: —–BEGIN RSA PRIVATE KEY—–. Steht dort was von OpenSSH, war der Export in puttygen falsch !!<\/h5>\n
Ich w\u00fcnsche jedenfalls gutes Gelingen und etwas Geduld, um der Anleitung sorgf\u00e4ltig folgen zu k\u00f6nnen\u00a0 !!<\/h5>\n
 <\/p>\n
 <\/p>\n
 <\/p>\n
 <\/p>\n","protected":false},"excerpt":{"rendered":"
Ein Synology Network Attached Storage (NAS) bietet neben der M\u00f6glichkeit einer eigenen Cloud auch die M\u00f6glichkeit eines eigenen Git-Servers. Dieser Artikel hilft ein…<\/p>\n","protected":false},"author":1,"featured_media":226,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[6],"tags":[8,7,9],"class_list":["post-224","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-computer","tag-git-server","tag-synology","tag-windows"],"_links":{"self":[{"href":"https:\/\/borck-online.com\/index.php?rest_route=\/wp\/v2\/posts\/224","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/borck-online.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/borck-online.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/borck-online.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/borck-online.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=224"}],"version-history":[{"count":0,"href":"https:\/\/borck-online.com\/index.php?rest_route=\/wp\/v2\/posts\/224\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/borck-online.com\/index.php?rest_route=\/wp\/v2\/media\/226"}],"wp:attachment":[{"href":"https:\/\/borck-online.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=224"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/borck-online.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=224"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/borck-online.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=224"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}