本教程旨在解决在 php 中使用 `exec` 命令通过 ssh 连接远程服务器时，无法自动输入密码的问题。我们将介绍如何利用 `sshpass` 工具，在非交互模式下安全地传递 ssh 密码，从而实现 php 脚本对远程服务器的自动化操作。文章将提供详细的代码示例，并深入探讨硬编码密码的安全风险，最终推荐使用 ssh 密钥对认证作为更安全的自动化登录最佳实践。
在 PHP 应用程序中，我们有时需要执行系统命令来与远程服务器进行交互，例如通过 SSH 运行某个脚本或获取系统信息。exec() 函数是 PHP 提供的一个强大工具，允许我们执行外部程序。然而，当尝试通过 SSH 连接远程服务器时，SSH 客户端通常会提示用户输入密码，这是一个交互式过程。由于 exec() 函数在非交互式环境中运行，它无法响应这种密码提示，导致 SSH 连接阻塞或失败。因此，我们需要一种方法来在命令执行时非交互地提供 SSH 密码。
以下是用户提供的原始 PHP 代码片段，它尝试使用 ssh 命令连接远程服务器并执行 uptime 命令：
<?php
$server = "IP"; // 远程服务器IP地址
$username = "root"; // SSH 用户名
$password = "pass"; // 密码（当前代码中未被用于SSH认证）
$port = "22"; // SSH 端口
$command = "uptime"; // 将在远程服务器上执行的命令
// 构造 SSH 命令字符串
$cmd_string = "ssh -p ".$port." ".$username."@".$server." ".$command;
// 执行命令
exec($cmd_string, $output);
// 输出结果
echo '';
print_r($output);
echo '';
?>这段代码构建了一个标准的 ssh 命令，例如 ssh -p 22 root@IP uptime。当 PHP 的 exec() 函数执行此命令时，ssh 客户端会尝试连接到远程服务器。如果服务器配置为密码认证，ssh 会在终端等待用户输入密码。由于 exec() 无法提供交互式输入，这个过程将无法完成，导致脚本卡住或因认证失败而退出。
为了解决 exec() 无法处理交互式密码的问题，我们可以使用一个名为 sshpass 的辅助工具。sshpass 允许用户在命令行中非交互式地提供 SSH 密码，然后将其传递给 ssh 命令。
立即学习“PHP免费学习笔记（深入）”；
sshpass 的主要功能是读取密码并将其传递给需要密码的命令（如 ssh、scp 等）。它支持多种传递密码的方式，最常用的是直接在命令行中指定密码或从文件中读取密码。
sshpass 并不是所有系统都默认安装的，因此您需要在运行 PHP 脚本的服务器上单独安装它。以下是一些常见 Linux 发行版和 macOS 上的安装命令：
sudo apt-get update sudo apt-get install sshpass
sudo yum install sshpass # 或者使用 dnf sudo dnf install sshpass
brew install sshpass
安装完成后，您可以通过运行 sshpass -V 来验证其是否成功安装并查看版本信息。
sshpass 通常与 ssh 命令结合使用，基本语法如下：
sshpass -p 'your_password' ssh [ssh_options] user@host [command]
其中：
现在，我们将修改原始 PHP 代码，将 sshpass 集成到 cmd_string 中，以实现自动化密码认证。
<?php
$server = "your_server_ip"; // 替换为您的远程服务器IP地址
$username = "your_username"; // 替换为您的SSH用户名
$password = "your_password"; // 替换为您的SSH密码
$port = "22"; // SSH 端口
$command = "uptime"; // 将在远程服务器上执行的命令
// **重要提示：硬编码密码存在安全风险，仅用于演示。**
// **在生产环境中，强烈建议使用 SSH 密钥对认证。**
// 确保 sshpass 已安装在执行此 PHP 脚本的服务器上。
// 构建包含 sshpass 的完整命令字符串
// 使用 escapeshellarg() 对参数进行转义，以防止命令注入和特殊字符问题
$cmd_string = "sshpass -p " . escapeshellarg($password) . " ssh -p " . escapeshellarg($port) . " " . escapeshellarg($username . "@" . $server) . " " . escapeshellarg($command);
// 执行命令，并获取输出和返回码
// $output 存储命令的输出行数组
// $return_var 存储命令的退出状态码 (0 表示成功)
exec($cmd_string, $output, $return_var);
// 根据返回码判断命令执行是否成功
if ($return_var === 0) {
echo "<h2>远程服务器 " . htmlspecialchars($server) . " 的 uptime 信息:</h2>";
echo "<pre>";
// 使用 htmlspecialchars() 确保输出内容在浏览器中安全显示
echo htmlspecialchars(implode("\n", $output));
echo "</pre>";
} else {
echo "<h2>执行命令时发生错误:</h2>";
echo "<p>错误码: " . htmlspecialchars($return_var) . "</p>";
echo "<pre>";
echo htmlspecialchars(implode("\n", $output));
echo "</pre>";
echo "<p>请检查 sshpass 是否已安装，SSH 用户名、密码、IP 和端口是否正确。</p>";
}
?>代码解释：
通过以上修改，PHP 脚本在执行 ssh 命令时将不再需要手动输入密码，实现了自动化登录。
尽管 sshpass 解决了 PHP exec 的密码认证问题，但直接在代码中硬编码密码或在命令行中传递密码（即使使用了 escapeshellarg）都存在显著的安全风险：
因此，在生产环境中，强烈不推荐使用 sshpass 结合硬编码密码的方式。更安全、更推荐的自动化登录方法是使用 SSH 密钥对认证。
SSH 密钥对认证是一种更安全的无密码登录机制，其工作原理如下：
生成密钥对： 在执行 PHP 脚本的服务器（本地服务器 A）上生成一对 SSH 密钥（公钥和私钥）。
ssh-keygen -t rsa -b 4096 -f ~/.ssh/id_rsa_php_automation -N ""
-N "" 表示不设置私钥密码，以便自动化使用。
部署公钥： 将生成的公钥（例如 ~/.ssh/id_rsa_php_automation.pub）复制到远程服务器（服务器 B）的 ~/.ssh/authorized_keys 文件中。
ssh-copy-id -i ~/.ssh/id_rsa_php_automation.pub user@remote_server # 或者手动复制 cat ~/.ssh/id_rsa_php_automation.pub | ssh user@remote_server "mkdir -p ~/.ssh && chmod 700 ~/.ssh && cat >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys"
修改 PHP 代码： 在 PHP 脚本中，修改 ssh 命令以指定私钥文件。此时，sshpass 将不再需要。
<?php
$server = "your_server_ip";
$username = "your_username";
$port = "22";
$command = "uptime";
// 指定私钥文件的路径
$private_key_path = "/var/www/.ssh/id_rsa_php_automation"; // 确保此路径可被 PHP 进程访问且权限正确
// 构建 SSH 命令字符串，使用 -i 参数指定私钥
$cmd_string = "ssh -i " . escapeshellarg($private_key_path) . " -p " . escapeshellarg($port) . " " . escapeshellarg($username . "@" . $server) . " " . escapeshellarg($command);
exec($cmd_string, $output, $return_var);
if ($return_var === 0) {
echo "<h2>远程服务器 " . htmlspecialchars($server) . " 的 uptime 信息 (通过密钥认证):</h2>";
echo "<pre>";
echo htmlspecialchars(implode("\n", $output));
echo "</pre>";
} else {
echo "<h2>执行命令时发生错误 (密钥认证):</h2>";
echo "<p>错误码: " . htmlspecialchars($return_var) . "</p>";
echo "<pre>";
echo htmlspecialchars(implode("\n", $output));
echo "</pre>";
echo "<p>请检查 SSH 密钥配置、用户权限和服务器连接。</p>";
}
?>注意事项：
本教程详细介绍了如何在 PHP 中利用 sshpass 工具解决 exec() 函数无法处理 SSH 交互式密码的问题，实现了远程服务器的自动化登录和命令执行。我们提供了具体的 PHP 代码示例，并强调了使用 escapeshellarg() 进行参数转义的重要性。
然而，为了生产环境的安全性和稳定性，我们强烈建议采用 SSH 密钥对认证作为自动化登录的首选方案。密钥对认证不仅消除了硬编码密码的风险，还提供了更强大的安全保障。通过结合最小权限原则、IP 访问限制和日志审计，可以构建一个既高效又安全的 PHP 远程服务器自动化管理系统。
以上就是PHP exec 实现 SSH 自动化登录与密码处理的详细内容，更多请关注php中文网其它相关文章！
PHP怎么学习？PHP怎么入门？PHP在哪学？PHP怎么学才快？不用担心，这里为大家提供了PHP速学教程(入门到精通)，有需要的小伙伴保存下载就能学习啦！
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
127
收藏
