萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 結合 FreeBSD 系統指令實現 FTP 使用者線上管理:popen、su、pw 指令實戰

專案背景

網頁設計大賽報名系統:使用者線上報名 → 寫入 MySQL → **自動建立 FTP 帳號/目錄** → 使用者 FTP 上傳作品。環境:FreeBSD + Apache + PHP + MySQL + 系統內建 FTP (vsftpd/proftpd 綁定系統用戶)。

核心挑戰:PHP 以非特權身份執行,需提權建立系統用戶

  • FreeBSD 無 `useradd`/`groupadd`,使用 `pw` 指令。
  • Apache 預設以 `nobody:nobody` 執行,無權 `pw useradd`。
  • 需透過 `su root -c '...'` 提權,並餵入 root 密碼。

系統層面前置作業

# 1. 建立 FTP 專用群組
pw groupadd ftpuser

# 2. 建立限制 Shell (僅允許 FTP、拒絕 SSH/Telnet)
cat > /bin/ftponly <<'EOF'
#!/bin/csh
/bin/cat << XX
You can only use this username to login ftp server!
And you can not use it to telnet to this system!
XX
sleep 10
exit 1
EOF
chmod +x /bin/ftponly

# 3. 將 /bin/ftponly 加入 /etc/shells
echo "/bin/ftponly" >> /etc/shells

# 4. 建立 wheel 群組用戶供 Apache 切換
pw useradd www -g wheel -s /bin/csh
# 設定密碼 (供 su 使用)
echo "www:StrongPassw0rd" | chpass

# 5. 修改 httpd.conf
User www
Group wheel
# 重啟 Apache

PHP 核心程式:checkin.php

<?php
// 1. 表單驗證、資料庫寫入 (略)
// 2. 取得註冊帳號 $username, 密碼 $password

// 3. 組裝建立用戶指令
// -g ftpuser: 指定群組
// -s /bin/ftponly: 指定限制 Shell
// -h 0: 密碼從 stdin 讀取 (避免 ps 顯示)
$cmd = "su root -c 'echo \"$password\" | pw useradd $username -g ftpuser -s /bin/ftponly -h 0'";

// 4. 以寫入模式開啟管道,餵入 root 密碼給 su
$fp = popen($cmd, 'w');
if (!$fp) {
    die('popen 失敗,無法建立用戶');
}
// su 會提示 Password:,寫入 root 密碼
fputs($fp, "ROOT_PASSWORD_HERE\n");
pclose($fp);

// 5. 建立 FTP 家目錄 (vsftpd 設定 local_root=/home/ftp/$USER)
$ftpDir = "/home/ftp/$username";
if (!is_dir($ftpDir)) {
    mkdir($ftpDir, 0755, true);
    // 修改擁有者 (需 root,可另寫腳本搭配 sudoers NOPASSWD)
    // system("chown -R $username:ftpuser $ftpDir");
}

// 6. 回報成功
echo "帳號建立完成,FTP 伺服器:ftp.example.com,用戶:$username";

關鍵函式解析

  • popen($cmd, 'w'):以**寫入模式**開啟管道,PHP 透過 `fputs()` 向指令標準輸入送資料 (此處餵 root 密碼給 `su`)。
  • pclose():關閉管道,等待指令結束,回傳狀態碼。
  • su root -c '...':切換至 root 執行單一指令,需密碼驗證。
  • pw useradd ... -h 0:`-h 0` 表示從標準輸入讀取密碼 (此處為 FTP 用戶密碼),避免明文出現在指令列。

安全性重大風險與現代化替代方案

風險影響現代解法
PHP 程式碼含 root 明文密碼原始碼洩漏即導致主機淪陷**勿在 PHP 執行系統管理指令**。改用 API + 獨立 Worker (systemd service) 處理帳號建立。
`popen` 注入風險用戶輸入未過濾可執行任意指令嚴格驗證帳號格式 `^[a-z0-9_-]{3,16}$`,使用 `escapeshellarg()`。
FTP 明文傳輸密碼/資料易被竊聽**強制 FTPS (TLS) 或改用 SFTP (SSH)**。
系統用戶 = FTP 用戶攻擊面大、權限管理困難虛擬用戶 (vsftpd `guest_enable=YES` + `user_config_dir` / ProFTPD `SQLAuth`)。

推薦架構:API + 隊列 + 權限分離

# 1. Web 端 (PHP/Laravel) - 僅寫入資料庫、推送隊列
Queue::push(new CreateFtpAccount($userId));

# 2. Worker (獨立進程、以低權限用戶運行、透過 sudoers 特定指令免密)
# sudoers: www ALL=(root) NOPASSWD: /usr/local/sbin/create-ftp-user
class CreateFtpAccount implements ShouldQueue {
    public function handle() {
        $user = User::find($this->userId);
        $output = shell_exec(sprintf(
            'sudo /usr/local/sbin/create-ftp-user %s %s',
            escapeshellarg($user->ftp_username),
            escapeshellarg($user->ftp_password)
        ));
        // 解析輸出、更新狀態
    }
}

# 3. /usr/local/sbin/create-ftp-user (root 擁有、700)
#!/bin/sh
# 使用 pw/useradd、設定虛擬用戶、建立目錄、配額
# 絕不輸出敏感資訊

總結

此範例展示「PHP 呼叫系統指令建立 FTP 帳號」的經典但**高風險**做法。現代架構應**將系統管理操作剝離為獨立微服務/Worker**,透過訊息隊列、最小權限 `sudoers`、虛擬用戶機制實現,徹底消除 Web 進程持有 root 權限的風險。

copyright © 萬盛學電腦網 all rights reserved