ゴグス

アクセス

• ブラウザを開いて次にアクセス: 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

サービス管理

ゴグ:

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=65535 in /etc/systemd/system/gogs.service、実行します systemctl daemon-reload そしてゴグスを再起動します。
• データベースの資格情報は次のように定義されます。 /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. ブラウザを開いて、次の場所にアクセスします。 https://yourdomain.com