编辑 selectorctl - 文件管理器

✏️ 编辑：selectorctl

路径：/usr/bin/selectorctl

大小：8.08 KB · 修改：2026-09-03 12:47:02 · 权限：0755 · 只读（保存会失败）

#!/opt/cloudlinux/venv/bin/python3 -sbb
# coding=utf-8
from __future__ import print_function
from __future__ import division
from __future__ import absolute_import
import subprocess
import sys
import getopt
import os

from clselect import (
    clpassenger,
    clprint,
    clselectctl,
    clselectctlphp,
    clselectctlpython,
    clselectctlruby,
    utils,
)

from clselect.utils import CAGEFS_ENTER_USER_BIN
from clcommon import clcagefs
from clcommon.cpapi import Feature, is_panel_feature_supported

def selector_executed_as_root():
    """
    We check whos run selector: root or user
    :return: True if root, False if user
    """

return os.geteuid() == 0

def _run_selectorctl_as_user_in_cagefs(user):
    """
    All user-related actions must run inside
    of cagefs for security reasons.

When selector is executed as root and we
    know username, we start new subprocess using su.
    But when selector is started by user and
    selectorctl is NOT in cagefs, we force cagefs_enter.
    """
    if selector_executed_as_root():
        if user is None:
            return
        cmd = [CAGEFS_ENTER_USER_BIN, user] + sys.argv + ['--skip-cagefs-check']
    elif not clcagefs.in_cagefs():
        cmd = ['/bin/cagefs_enter'] + sys.argv + ['--skip-cagefs-check']
    else:
        return
    p = subprocess.Popen(cmd, stdout=sys.stdout, stdin=sys.stdin, env={})
    p.communicate()
    sys.exit(p.returncode)

def usage():
    print('Usage: ' + sys.argv[0] + ' [OPTIONS]')
    print('Options:')
    print()
    print(' -i | --interpreter               : Interpreter. If omitted php implied')
    print(' -h | --help                      : Show this message')
    print(' -A | --fix-homedir               : Fix paths after home directory change')
    print()
    print('According to selected interpreter options differs')
    print(' PHP:')
    clselectctlphp.usage()
    print()
    print(' Python:')
    clselectctlpython.usage()
    print()
    print(' Ruby:')
    clselectctlruby.usage()

def main():
    try:
        opts, args = getopt.getopt(
            sys.argv[1:],
            'hi:lSsCcB:Y:N:E:D:R:v:Gu:b:ge:d:r:atpVLT:k:m:x:QqPjwWzynfFZo:AK:U', [
                'help',
                'setup-without-cagefs',
                'revert-to-cagefs',
                'interpreter=',
                'list',
                'list-user-webapps',
                'summary',
                'user-summary',
                'current',
                'user-current',
                'set-current=',
                'enable-alternative=',
                'disable-alternative=',
                'enable-extensions=',
                'disable-extensions=',
                'replace-extensions=',
                'version=',
                'list-extensions',
                'user=',
                'domain=',
                'set-user-current=',
                'list-user-extensions',
                'enable-user-extensions=',
                'disable-user-extensions=',
                'replace-user-extensions=',
                'all',
                'reset-user-extensions',
                'print-summary',
                'show-native-version',
                'list-users',
                'change-to-version=',
                'add-options=',
                'replace-options=',
                'delete-options=',
                'base64',
                'quiet',
                'print-options',
                'print-options-safe',
                'apply-symlinks-rules',
                'json',
                'csv',
                'perl',
                'api-version=',
                'verbose',
                'reset-options',
                'create-webapp',
                'update-interpreter',
                'destroy-webapp',
                'relocate-webapp',
                'transit-webapp',
                'restart-webapp',
                'start-webapp',
                'stop-webapp',
                'setup-wsgi=',
                'fix-homedir',
                'list-extensions-version=',
                'recreate-virtualenv',
                'freeze-requirements',
                'update-backup',
                'apply-global-php-ini',
                'app-mode=',
                'startup-file=',
                'env-vars=',
                'set-variables',
                'skip-cagefs-check',
                'exclude-pid-list=',
                'for-all-users'
            ])
    except getopt.GetoptError:
        usage()
        sys.exit(1)

action = None
    interpreter = 'php'
    fmt = 'text'
    user = None
    domain = None

# getopt is a little bit stupid parser
    # after a non-option argument, all further arguments are
    # considered also non-options
    # so sometimes my '--skip' option was ignored
    #
    # Scanner note (F-01, CLOS-5515, 2026-07-17): argv-driven --skip-cagefs-check
    # is not an implicit-trust marker. `selectorctl` is only reachable via the
    # %clsudoers NOPASSWD alias, whose membership is pinned to panel admins()
    # + package-owned service accounts by commons/lib/lvemanager/sudoers.py:326
    # (cPanel admins()={root}; DA/Plesk admins already hold root-equivalent
    # NOPASSWD). No privilege boundary is crossed by the flag.
    skip_enter_cagefs = '--skip-cagefs-check' in sys.argv
    if skip_enter_cagefs:
        sys.argv.remove('--skip-cagefs-check')

# Catch this options in any position
    if '-h' in sys.argv or '--help' in sys.argv:
        usage()
        sys.exit(0)

for o, a in opts:
        if o in ['-i', '--interpreter']:
            interpreter = a.lower()
        elif o in ['-j', '--json']:
            fmt = 'json'
        elif o in ['-w', '--csv']:
            fmt = 'csv'
        elif o in ['-W', '--perl']:
            fmt = 'perl'
        elif o in ['-A', '--fix-homedir']:
            action = 'fix-homedir'
        elif o == '--update-interpreter':
            action = 'update-interpreter'
        elif o in ['-u', '--user']:
            user = a
        elif o == '--domain':
            domain = a

if interpreter == 'php':
        if not is_panel_feature_supported(Feature.PHP_SELECTOR):
            clprint.print_diag(
                fmt,
                {'status': 'ERROR',
                'details': 'selectorctl for php interpreter is not supported in current environment'
                }
            )
            sys.exit(0)
        else:
            return clselectctlphp.main()

# Skip special "wildcard user" that is used only with "update-interpreter"
    if not (action == 'update-interpreter' and user == '*'):
        user, _ = utils.safely_resolve_username_and_doc_root(
                user, domain, fmt, True)

if not skip_enter_cagefs and \
            (interpreter in ['ruby', 'nodejs']
             or (interpreter == 'python' and not action == 'update-interpreter')):
        _run_selectorctl_as_user_in_cagefs(user)

if action == 'fix-homedir':
        fix_homedir(user)
        sys.exit()

if interpreter == 'python':
        # no feature check here because "selectorctl utility for --interpreter python is deprecated. Only update-interpreter option is still possible to use"
        # and update-interpreter silently does nothing or prints its own warning in case of unsupported environment
        clselectctlpython.main()
    elif interpreter == 'ruby':
        if not is_panel_feature_supported(Feature.RUBY_SELECTOR):
            clprint.print_diag(
                fmt,
                {'status': 'ERROR',
                'details': 'selectorctl for ruby interpreter is not supported in current environment'
                }
            )
            sys.exit(0)
        else:
            clselectctlruby.main()
    elif interpreter == 'nodejs':
        clprint.print_diag(
            fmt, {'status': 'ERROR',
                  'details': 'For --interpreter nodejs please use cloudlinux-selector utility instead'})
        sys.exit(1)
    else:
        clprint.print_diag(
            fmt, {'status': 'ERROR', 'message': 'Unknown interpreter'})
        sys.exit(1)

def fix_homedir(user):
    user = clselectctl.get_user(user)
    clpassenger.fix_homedir(user)
    clselectctlpython.fix_homedir(user)

if __name__ == '__main__':
    main()