ドキュメント

クイックスタート + 機能・デバイスごとの解説(随時更新中)

大手クラウドサーバー(非 root ユーザー)の利用ガイド

これはどのような状況か

テンセントクラウド、Alibaba Cloud、Huawei Cloud などの大手クラウドサーバーは、セキュリティのためデフォルトで root ログインを禁止しており、一般ユーザーでのみログインできます(Ubuntu は ubuntu、Debian は admin、CentOS は centos)。これらの一般ユーザーは通常 sudo グループに属し、デフォルトでパスワードなし sudo(sudo コマンド実行時にパスワードを要求しない)が設定されています。

パネルにとって何を意味するか

一般ユーザーでサーバーにログインする場合、パネル内の「管理者権限が必要」なすべての操作——ソース切り替え、Docker のインストール、ソフトウェアのインストール、ファイアウォールの設定など——は、パネルが自動的に sudo を前置して権限昇格します。追加の設定は一切不要で、そのまま通常どおり使用できます。

パネルが自動で処理する方法

パネルにはスマートな権限昇格の仕組みが組み込まれており、自動的に判断して処理します:

1. 現在のユーザーを識別:接続後、ログインしているのが root か一般ユーザーかを自動的に判断します。

2. パスワードなし sudo を検出:一般ユーザーの場合、パスワードなし sudo がサポートされているかを自動的に検出します(結果はキャッシュされ、繰り返し検出しません)。

3. 自動で権限昇格:「root が必要な操作系コマンド」(apt-get install、yum/dnf install、systemctl、/etc/ への書き込み、nginx -s reload、証明書の申請など)に対して自動的に sudo -n sh -c '...' を前置します。

4. 読み取り専用コマンドには干渉しない:cat、whoami、pwd、command -v のような確認/検出系コマンドには sudo を付けず、そのまま実行します。

5. root ユーザーには影響ゼロ:root でログインしている場合、コマンドはそのまま返され、動作はまったく変わりません。

サーバー追加時の入力方法

フィールド推奨値
ユーザー名一般ユーザー名(ubuntu / centos / admin など)
認証方式パスワード または 秘密鍵(大手クラウドは通常デフォルトでキーペアが提供されるため、秘密鍵を推奨)

以降の権限昇格はパネルが自動的に行うため、手動で前に sudo を付ける必要はありません。

どのような場合に失敗するか

パスワードなし sudo が前提です。サーバーが「sudo にパスワードが必要」に変更されている場合、パネルは自動で権限昇格できず、明確なメッセージを返します:「root でログインし直すか、パスワードなし sudo を設定してください」。静かに失敗したり、成功したと偽って報告したりすることはありません。

一般ユーザーでもパスワードなし sudo を使えるようにしたい場合は、サーバー上で以下を実行します:

# 把当前用户加入 sudo 组(如未加入)
sudo usermod -aG sudo 用户名
# 配置免密 sudo(编辑 sudoers)
echo "用户名 ALL=(ALL) NOPASSWD: ALL" | sudo tee /etc/sudoers.d/用户名

注意事項

1. 大手クラウドのデフォルトユーザー(ubuntu / centos / admin)はいずれもパスワードなし sudo であり、そのまま正常に使用できます。

2. サーバーのユーザーがわからない場合は、サーバーにログインして whoami を実行し、現在のユーザー名を確認してください。

3. パネルの権限昇格は「操作系コマンド」のみを対象とし、確認や監視系の機能には影響しません。