よくある質問 FAQ

本記事では、パネルを使う中で最もよくある問題とその調査方法をまとめます。

インストールとログイン

Q: パネルのインストールには何が必要ですか？

グローバル IP を持つ Linux サーバー 1 台（Debian / Ubuntu / CentOS などの主要ディストリビューションを推奨）。メモリは 512MB 以上あれば快適に動作します。管理される側のサーバーは何もインストールする必要がなく、SSH 接続できることだけが必要です。

Q: 既定のアカウント/パスワードは？

既定のアカウントは admin、パスワードは 123456。初回ログイン後すぐに変更してください（パネル右上のユーザーアイコン → ユーザー設定）。

Q: ログインパスワードを忘れた場合は？

変更後に忘れてしまった場合、パネルサーバー上でリセットできます。次のコマンドで既定のパスワード（または指定した新しいパスワード）にリセットします：

# パネルのインストールディレクトリに入り、内蔵スクリプトでパスワードをリセット
cd /opt/ssh-everywhere
python3 -c "from app import reset_password; reset_password('新しいパスワード')"

> 具体的なスクリプト名はバージョンによって変わる場合があります。データベース data/ssheverywhere.db の users テーブルを直接編集する方法もあります。

Q: パネルのポート（5501）を変更するには？

systemd サービス内の Environment=PORT=5501 を変更し、リロードします：

systemctl edit ssh-everywhere.service
# 追加または変更：Environment=PORT=あなたのポート
systemctl daemon-reload && systemctl restart ssh-everywhere.service

変更後はクラウドファイアウォール/セキュリティグループで新しいポートを許可するのを忘れないでください。

Q: パネル（5501 ポート）にアクセスできない？

順番に調査します：

1. パネルサービスが動作しているか確認：systemctl status ssh-everywhere.service

2. パネルサーバーのクラウドファイアウォール/セキュリティグループで 5501 が許可されているか確認（これが最もよくある原因です）

3. アクセス先が http://サーバーのグローバルIP:5501 であることを確認（https ではない。リバースプロキシを設定している場合を除く）

サーバー関連

Q: サーバーが「オフライン」と表示されたら？

「オフライン」はパネルが SSH でそのサーバーに接続できないことだけを示し、サーバーのダウンを意味しません。順番に調査します：

1. サーバー自体がオンラインか確認：サーバープロバイダーのコンソールで電源状態を確認

2. SSH ポートの到達性をテスト：パネルサーバーから nc -zv <対象IP> <ポート> を実行し、ポートが通じるか確認

3. ファイアウォール/セキュリティグループを確認：対象サーバーのクラウドファイアウォール/セキュリティグループで SSH ポートが許可されているか

4. NAT サーバーはポートマッピングを確認：NAT ポートマッピングがまだ存在し、対象の内部 IP が正しいか確認

5. 接続元 IP のホワイトリストを確認：一部のプロバイダーは SSH ポートに接続元 IP 制限を設けているため、パネルサーバーの IP をホワイトリストに追加する必要があります

6. アカウント/パスワードを照合：ユーザー名、パスワード/秘密鍵が正しいか

Q: サーバー追加時に接続できない？

SSH ポート、ユーザー名、パスワードが正しいことを確認
対象サーバーで sshd が動作していることを確認
ファイアウォールで SSH ポートが許可されていることを確認
大手クラウド（テンセントクラウド/阿里云）は既定で root が無効化されているため、一般ユーザー（ubuntu など）でログインしてください

Q: NAT サーバー（22 番以外のポート）に接続できない？

NAT サーバーのポートマッピングは、パネルサーバーが属するネットワークからアクセスできる必要があります。よくある原因：

ポートマッピングの失効（プロバイダーの管理画面で確認/再作成）
プロバイダーが接続元 IP にホワイトリストを設定（パネルサーバーの IP を追加）
マッピングする対象の内部 IP/ポートの記入ミス

ポートトンネリング / 転送関連

Q: ポートトンネリングが「オフライン」と表示される？

トンネリングは Agent のオンラインに依存します。Agent がオフライン（デバイスの電源断、ネットワーク切断、Agent の停止）になるとトンネリングは中断します
パネルサービス再起動後、トンネリングは Agent の再接続時に自動復旧します。少し待てば大丈夫です
パネルサーバーのクラウドファイアウォールでリッスンポートが許可されているか確認してください

Q: 22 番以外のポートを転送しても効かない？

SSH 以外のポート（9117 など）を転送するには、トンネルサーバーに新しいバージョンの Agent がインストールされている必要があります（旧バージョンは 22 のみ対応）。Agent を再インストールすれば解決します。

Q: ポート転送を作成したのに効かない？

従来のポート転送は、独立したグローバル IP を持つサーバー自身で実行する必要があります。次を確認してください：

1. 対象サーバー/中間ファイアウォールで対象ポートが許可されているか

2. 対象 IP が実際に到達可能なアドレスか

3. クラウドのセキュリティグループがリッスンポートを遮断していないか

Q: ポートトンネリングとポート転送の違いは？

ポートトンネリング：グローバル IP を持たないデバイス向け。リバーストンネルを通り、パネルサーバー上にグローバルポートを開きます。
ポート転送：グローバル IP を持つサーバー向け。システムファイアウォールの DNAT を通り、対象サーバー自身で実行します。

詳しくはポートトンネリングとポート転送を参照してください。

Docker / アプリインストール関連

Q: アプリ一覧/Docker のインストールに失敗したら？

パネルはエラーメッセージをそのまま表示します（成功したと偽りません）。よくある原因：

1. 古すぎるディストリビューション：Fedora 32 など EOL 済みのバージョンはソフトウェアリポジトリが保守終了しており、インストールがタイムアウトまたは失敗します。システムのアップグレードを推奨します。

2. ネットワーク到達不可：Docker 公式リポジトリ（get.docker.com / download.docker.com）は一部のネットワーク環境（中国大陸の NAT サーバーなど）からアクセスできない場合があります。その場合は Docker の国内ミラーを設定するか、「ミラー」機能で Alibaba Cloud のミラーに切り替えてください。

3. パッケージ名の差異：一部のアプリ（ufw、Node.js の deb.nodesource など）は特定のディストリビューションに依存し、Debian/Ubuntu 以外ではインストールできない場合があります。エラーメッセージに明確に表示されます。

Q: 中国国内のサーバーで Docker イメージの取得が遅い/タイムアウトする？

これはネットワークの問題で、パネルの問題ではありません。Docker ミラーアクセラレーター（公共アクセラレーター例：docker.1ms.run / docker.m.daocloud.io）を設定するか、サーバー上で先に次を実行することを推奨します：

# 参考：Alibaba Cloud の個人アクセラレーターを設定（あなたのアクセラレーターアドレスに置き換えてください）
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<'EOF'
{ "registry-mirrors": ["https://あなたのアクセラレーターアドレス"] }
EOF
sudo systemctl restart docker

共通の調査テクニック

1. まずポートが通じるかをテストし、その後にアカウント/パスワードを調査：nc -zv <IP> <ポート>

2. 他のサーバーと比較：同種のサーバーは接続できて、この 1 台だけ接続できないなら、問題はこの 1 台固有（ファイアウォール/マッピング/ホワイトリスト）

3. ログを見る：パネルのログは service.log にあり、トンネル/Agent のログは接続問題の切り分けに役立ちます

ドキュメント