使用PHP和sshpass实现SSH自动密码认证连接服务器教程-php教程-PHP中文网

使用PHP和sshpass实现SSH自动密码认证连接服务器教程

心靈之曲

发布： 2025-11-11 12:31:18

原创

249人浏览过

使用PHP和sshpass实现SSH自动密码认证连接服务器教程

本教程详细介绍了如何在php中使用`exec`函数通过ssh连接远程服务器并执行命令，重点解决手动输入密码的问题。我们将引入`sshpass`工具，演示如何将其集成到php脚本中，实现ssh连接的自动化密码认证，并提供完整的代码示例及重要的安全实践建议。

PHP中执行SSH命令的基础

在PHP中，我们可以利用exec()函数来执行外部系统命令，这使得我们能够通过命令行接口与服务器进行交互，包括执行SSH命令连接远程服务器。基本的SSH命令结构通常是ssh -p [端口] [用户名]@[服务器IP或域名] [要执行的命令]。

考虑以下PHP代码片段，它尝试连接远程服务器并执行uptime命令：

<?php
    $server = "你的服务器IP或域名"; // 例如: "192.168.1.100"
    $username = "root"; // SSH用户名
    // $password = "pass"; // 密码在此处无法直接使用
    $port = "22"; // SSH端口
    $command = "uptime"; // 将在远程服务器上执行的命令

    // 构造SSH命令字符串
    $cmd_string = "ssh -p ".$port." ".$username."@".$server." ".$command;

    // 执行命令
    $output = [];
    exec($cmd_string, $output);

    // 输出结果
    echo '<h2>远程服务器命令执行结果：</h2>';
    echo '<pre>';
    print_r($output);
    echo '</pre>';
?>

登录后复制

上述代码能够构建并执行SSH命令。然而，当SSH服务器配置为密码认证且没有预设SSH密钥时，执行此命令会在PHP脚本运行的终端（如果通过CLI执行）或Web服务器后台（如果通过Web访问）等待用户手动输入密码。这对于自动化脚本来说是一个严重的障碍，因为它需要人工干预。

使用sshpass实现自动化密码认证

为了解决SSH命令在脚本中需要手动输入密码的问题，我们可以引入sshpass工具。sshpass是一个非交互式的SSH密码认证工具，它允许在命令行中直接提供密码，从而实现SSH连接的自动化。

立即学习“PHP免费学习笔记（深入）”；

什么是sshpass？

sshpass是一个简单的命令行工具，它通过管道或命令行参数将密码传递给SSH客户端，从而绕过SSH客户端的交互式密码提示。这使得在脚本中执行需要密码认证的SSH命令成为可能。

安装sshpass

sshpass不是SSH客户端的默认组成部分，需要单独安装。在大多数基于Linux的系统中，可以通过包管理器轻松安装：

Debian/Ubuntu:

sudo apt-get update
sudo apt-get install sshpass

登录后复制

CentOS/RHEL:

sudo yum install epel-release
sudo yum install sshpass

登录后复制

macOS (通过Homebrew):

brew install hudochenkov/sshpass/sshpass

登录后复制

安装完成后，可以通过运行 which sshpass 命令来验证其是否成功安装并位于系统路径中。

sshpass的工作原理

sshpass的基本用法是在SSH命令前加上 sshpass -p '密码'。例如：

sshpass -p 'your_password' ssh user@host 'command_to_execute'

登录后复制

当sshpass接收到密码后，它会将其传递给后续的ssh命令，使其能够进行非交互式认证。

码上飞

码上飞（CodeFlying）是一款AI自动化开发平台，通过自然语言描述即可自动生成完整应用程序。

138

查看详情

集成sshpass到PHP脚本

现在，我们将sshpass集成到之前的PHP脚本中，以实现自动化密码认证：

<?php
    // 服务器连接参数
    $server = "你的服务器IP或域名"; // 例如: "192.168.1.100" 或 "your.domain.com"
    $username = "root"; // SSH用户名
    $password = "你的SSH密码"; // 注意：此处直接暴露密码存在安全风险，生产环境不推荐
    $port = "22"; // SSH端口
    $command = "uptime"; // 将在远程服务器上执行的命令

    // (可选但推荐) 检查sshpass是否已安装，如果未安装，脚本将无法正常工作
    // if (exec('which sshpass') == '') {
    //     die("错误：sshpass未安装。请先安装sshpass。");
    // }

    // 构建包含sshpass的完整SSH命令
    // 语法: sshpass -p '密码' ssh -p 端口 用户名@服务器 命令
    // 注意：使用escapeshellarg()函数对参数进行转义，以防止命令注入攻击，特别是密码和服务器名称等变量。
    $cmd_string = "sshpass -p " . escapeshellarg($password) . " ssh -p " . escapeshellarg($port) . " " . escapeshellarg($username) . "@" . escapeshellarg($server) . " " . escapeshellarg($command);

    // 在本地执行命令
    $output = [];
    $return_var = 0; // 用于捕获命令的返回码
    exec($cmd_string, $output, $return_var);

    // 输出结果
    echo '<h2>远程服务器命令执行结果：</h2>';
    if ($return_var === 0) { // 返回码为0通常表示命令成功执行
        echo '<pre>';
        print_r($output);
        echo '</pre>';
    } else {
        echo '<p style="color: red;">命令执行失败，返回码：' . $return_var . '</p>';
        echo '<pre>';
        print_r($output); // 打印错误输出，可能包含sshpass或ssh的错误信息
        echo '</pre>';
    }
?>

登录后复制

在这个修改后的代码中：

我们定义了$password变量来存储SSH密码。
$cmd_string的构建方式发生了变化，将sshpass -p '密码'前置到ssh命令之前。
escapeshellarg()函数的使用至关重要。 它会为字符串添加单引号，并转义其中可能存在的特殊字符，从而确保字符串作为单个参数传递给命令，有效防止命令注入攻击。

安全实践与替代方案

尽管sshpass提供了一种便捷的自动化密码认证方式，但它也带来了显著的安全风险，尤其是在生产环境中。

硬编码密码的风险

在PHP脚本中直接硬编码密码（如 $password = "你的SSH密码";）是非常不安全的行为。一旦PHP文件被泄露，攻击者将直接获取服务器的SSH密码。即使文件权限设置严格，也存在内部人员滥用或系统漏洞导致泄露的风险。

推荐的替代方案：SSH密钥认证

最安全、最推荐的自动化SSH认证方式是使用SSH密钥对。SSH密钥认证的原理是：

在本地客户端生成一对密钥（公钥和私钥）。
将公钥上传到远程服务器的~/.ssh/authorized_keys文件中。
私钥保留在本地客户端，并受到严格保护（通常有密码保护）。

配置好SSH密钥认证后，SSH客户端在连接时会尝试使用私钥进行认证，如果成功，则无需密码即可登录。这种方式不仅更安全（私钥通常有更强的加密保护，且不需要在每次连接时传递），也更加方便。

使用SSH密钥认证的优势：

安全性更高： 私钥不会在网络上传输，降低了被截获的风险。
自动化： 一旦配置完成，SSH连接将完全自动化，无需sshpass。
管理方便： 可以为不同的服务器或用户生成不同的密钥对。

限制sshpass的使用

如果由于特定环境限制，确实需要使用sshpass，请务必遵循以下安全建议：

最小权限原则： 运行PHP脚本的用户应具有最小的权限，限制其对敏感文件的访问。
避免硬编码： 尽量不要在代码中直接写入密码。可以考虑从环境变量、安全的配置文件（且权限严格限制）或安全的密钥管理服务中动态读取密码。
严格控制文件权限： 确保包含密码的PHP文件以及任何配置文件都具有严格的读取权限，仅允许Web服务器进程访问。
仅在信任网络中使用： 避免在公共网络或不信任的环境中传输包含密码的SSH命令。
日志审计： 记录所有通过sshpass进行的SSH连接尝试，以便进行安全审计。

总结

sshpass为PHP脚本提供了一种在非交互式环境中执行SSH命令并进行密码认证的有效方法。通过将其与PHP的exec()函数结合，我们可以实现对远程服务器的自动化操作。然而，这种便利性伴随着显著的安全风险。在任何生产环境中，强烈建议优先考虑使用SSH密钥对进行认证，以提供更高级别的安全性和自动化能力。如果确实需要使用sshpass，请务必采取严格的安全措施，避免直接硬编码密码，并确保对所有敏感信息进行妥善保护。

以上就是使用PHP和sshpass实现SSH自动密码认证连接服务器教程的详细内容，更多请关注php中文网其它相关文章！