WindowsのローカルGiteaが開かないときに確認する3か所

Windows上のローカルGiteaが開かないときに、そのPCでHTTP応答まで確かめる 開発環境

運用で使っている起動スクリプトは、Giteaのプロセスを見つけるとPIDを表示します。PIDはWindowsで動いているプログラムの識別番号です。起動時に番号が出ても、ブラウザがつなぎに行くポートでGiteaが応答するかは別です。

Giteaを動かしているWindows PCで http://127.0.0.1:3000/ が開かないときは、3000番で接続を受け付けているかから調べます。待ち受けがあれば、そのポートを使っているプログラムを確認してからHTTP応答を見ます。

127.0.0.1 は操作中のPCを指します。運用で使っているGiteaは1.25.5で、以下はGitea本体にHTTPで直接つなぐ例です。この版の既定のWebポートは3000番。別の設定で起動している場合は、実際に使っているポート番号と接続方式に読み替えてください。 Gitea 1.25のWebサーバー設定

ローカルGiteaの待ち受けポート、そのポートを使うプロセス、HTTP応答を順に調べる図
待ち受けポート、ポートを使っているプログラム、Webの応答を順に確かめます。

3000番で待ち受けているか

Giteaを動かしているWindows PCでPowerShellを開きます。次のコマンドは、Windowsの接続一覧から、左側のローカルアドレスが :3000 で終わるTCPの行を拾います。別番号を使う環境では 3000 をその番号に置き換えてください。 Microsoftのnetstatコマンド仕様

netstat.exe -ano | Select-String '^\s*TCP\s+\S+:3000\s'

次の行は表示例です。右端の 4321 がPIDです。

  TCP    127.0.0.1:3000    0.0.0.0:0    LISTENING    4321

LISTENING は接続を受け付ける状態です。3000番に複数の行があれば、ブラウザが開こうとしている 127.0.0.1:3000 の行を見ます。0.0.0.0:3000 も、そのアドレスを含むすべてのローカルIPv4アドレスで待ち受けています。別のアドレスの行しか出ない場合は、ブラウザの接続先と待ち受け先を照合します。

3000番に LISTENING がなければ、Giteaの起動状況と実際の待ち受け設定を確認します。 ESTABLISHED など、別の状態の行だけでは待ち受けを確認できません。

右端のPIDが gitea か

接続先に対応する LISTENING 行の右端を、次の 4321 の代わりに入れます。Giteaが使っていれば ProcessName に gitea が出ます。PIDが見つからなければ、プロセスが終了した可能性があります。netstat をもう一度実行してください。

Get-Process -Id 4321 | Select-Object Id, ProcessName
  Id ProcessName
  -- -----------
4321 gitea
結果 次に確認する場所
LISTENING がなく、Get-Process gitea にも該当がない 普段使う起動方法と直近の起動ログを確認する。ログイン時に自動起動させている場合は、タスク スケジューラの前回の実行結果も見る。
gitea はいるが、3000番に LISTENING がない 起動ログで待ち受け先を調べ、起動時に指定された設定ファイルと照合する。
3000番のPIDが別のプロセス 3000番に応答するアプリを取り違えている可能性がある。Giteaが使う予定の番号と起動ログを確認する。
3000番のPIDが gitea 接続先のアドレスを確認し、HTTP応答を調べる。

3000番を使っているプロセスは、名前と用途が分かるまで停止しないでください。 そのアプリも必要なら、Giteaが別のポートを使う構成を検討します。

運用例の自動起動タスクは、Windowsへのログオンをきっかけに起動する設定です。再起動直後やスリープ復帰後だけ開けない場合は、タスクの実行結果に加えて、トリガーがいつ実行される設定かを見てください。

設定ファイルは起動時に指定されたものを開く

起動用のショートカットやスクリプトに --config があれば、その引数に書かれたファイルが確認先です。冒頭の起動スクリプトでも、この引数で設定ファイルを指定しています。指定が見当たらなければ起動ログを確認します。起動引数の --port があれば、app.ini のポート指定より優先されます。 Gitea 1.25の起動オプション / 設定ファイルを探す方法

起動時に読み込む app.ini が分かったら、[server] の項目を確認します。

項目 確認すること
HTTP_ADDR、HTTP_PORT Giteaが接続を受け付けるアドレスとポート。Windowsの待ち受け一覧やブラウザの接続先と照合する。
PROTOCOL Gitea本体への直接アクセスに使う方式。http と https のどちらで開くかを決める。
ROOT_URL Giteaが利用者向けのベースURLを生成するときの設定。リンク先が予想したホストと違う場合の確認先。

接続を受け付ける場所は HTTP_ADDR と HTTP_PORT で確認します。 ROOT_URL にポート番号が入っていても、そこで待ち受ける設定になるわけではありません。ファイルを開いた時点では値を変更せず、まず起動引数と照合します。 Gitea 1.25のWebサーバー設定

URLに直接アクセスして最初のHTTP応答を見る

3000番を使っているのがGiteaだと確認できたら、同じPowerShellで次を実行します。Windowsの curl.exe が利用できる場合の手順です。転送先を自動で追わず、最大5秒で最初の応答ヘッダーを表示します。 curl公式マニュアル

curl.exe -q --noproxy 127.0.0.1 --max-time 5 -sS -D - -o NUL http://127.0.0.1:3000/
出力の例 読み方と次に見る場所
200 入口のリクエストに応答がある。ブラウザを開き、Giteaの画面を確認する。
302 と Location 別のURLへ案内されている。例として Location: /user/login なら同じホストのログイン画面への案内。別のホストが出る場合は、その接続先が普段の構成と合うか確かめる。
404 や 500 HTTPの応答は届いている。404 ならURLの途中のパス、500 なら同時刻のGiteaのログを確認する。
curl: (7) や curl: (28) 接続に失敗したか、制限時間内に処理が終わらなかった。接続先のアドレス、ポート、方式と起動ログを再確認する。

HTTPの応答が返ってきたら、ブラウザでいつものURLを開き、ログイン後に目的のリポジトリを表示できるかを確かめます。以前から使っている環境で急にセットアップ画面が出たら、フォームを送信する前に、起動時に読み込んだ設定とデータの場所を調べます。 HTTPステータスコードの仕様

同じPCでは開けて、別の端末からだけ開けないなら、次に見るのは端末間の接続です。スマホから自宅PCに接続したときのTailscale構成

コメント

タイトルとURLをコピーしました