アクセス
- ブラウザを開いて次の URL にアクセスしてください :
https://<SERVER_IP> - ブラウザに SSL 警告が表示されることがあります(自己署名証明書のため)
- 新しいアカウントを登録する
- 最初に登録したアカウントが管理者になります
セルフ登録を無効にする(任意)
デフォルトでは、ユーザーのセルフ登録が有効になっています。
1. 設定ファイルを編集する: /etc/gogs/conf/app.ini
2. 以下の [auth] セクション、変更 DISABLE_REGISTRATION = false to DISABLE_REGISTRATION = true
3. Gogsを再起動します:
systemctl restart gogs
主要なファイルとディレクトリ
- インストール ディレクトリ:
/opt/gogs - 設定ファイル:
/etc/gogs/conf/app.ini - アプリケーションデータ:
/var/lib/gogs - リポジトリ:
/var/lib/gogs/repositories - ログ:
/var/log/gogs - Systemdサービス
/etc/systemd/system/gogs.service - Nginx設定
/etc/nginx/sites-available/gogs.conf - TLS証明書:
/etc/nginx/ssl/
Git使用方法
HTTPS(自己署名証明書):
GIT_SSL_NO_VERIFY=true git clone https://<SERVER_IP>/<USERNAME>/<REPOSITORY>.git
SSH(組み込みサーバー):
git clone ssh://git@<SERVER_IP>:2222/<USERNAME>/<REPOSITORY>.git
サービス管理
Gogs:
systemctl status gogs
systemctl restart gogs
Nginx:
systemctl status nginx
systemctl restart nginx
PostgreSQL:
systemctl status postgresql
systemctl restart postgresql
注釈
- メインの設定ファイルはここにあります:
/etc/gogs/conf/app.ini。設定ファイルを変更した後は、次のコマンドでサービスを再起動してください:systemctl restart gogs. - Nginx のアップロード上限は次のファイルで定義されています:
/etc/nginx/sites-available/gogs.confを使用してclient_max_body_size。大規模なリポジトリの場合はこの値を増やし、Nginx を再起動してください。 - 大規模なデプロイでは、以下のコメントアウトを解除できます
LimitMEMLOCK=infinityとLimitNOFILE=65535in/etc/systemd/system/gogs.service、その後実行systemctl daemon-reloadを編集し、Gogs を再起動してください。 - データベースの認証情報は以下で定義されています
/etc/gogs/conf/app.ini. - 本番環境では、自己署名証明書を有効な Let's Encrypt 証明書に置き換えることを推奨します。
- 自己署名証明書を使用する場合、HTTPS によるクローンには以下が必要です
GIT_SSL_NO_VERIFY=true.
ドメインを使った SSL の有効化
1. ドメインをサーバーのIPアドレスに向けてください。
2. Gogs の設定を更新する(/etc/gogs/conf/app.ini):
EXTERNAL_URL = https://yourdomain.com/
DOMAIN = yourdomain.com
SSH_DOMAIN = yourdomain.com
3. 変更を反映するため Gogs サービスを再起動する:
systemctl restart gogs
3. Nginx の設定ファイルを編集し、両方の server_name <IP>; ドメイン(<your-domain>) は HTTP (ポート 80) と HTTPS (ポート 443) の両ブロックに適用されます:
vim /etc/nginx/sites-available/gogs.conf
4. Certbotをインストール:
apt install -y certbot python3-certbot-nginx
5. 以下のコマンドを実行して有効な Let's Encrypt 証明書を生成する:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
6. Nginx の設定内の SSL パスを置き換える:
vim /etc/nginx/sites-available/gogs.conf
# Before:
# ssl_certificate /etc/nginx/ssl/gogs.crt;
# ssl_certificate_key /etc/nginx/ssl/gogs.key;
# After:
# ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
# ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;
7. 変更を反映するため Nginx を再起動する:
systemctl restart nginx
8. ブラウザを開き、以下の URL にアクセスする: https://yourdomain.com