首先，我们将介绍从 GitHub 安装此项目的传统方法。稍后，我们将介绍一种更简单的方法来安装此脚本，以便我们可以在全球范围内使用它。

首先，使用 git 将存储库克隆到您的设备。您可以在终端中输入以下命令来执行此操作。

git clone https://github.com/bellingcat/telegram-phone-number-checker.git

🗒️如果您的设备上尚未安装 git，请使用本指南进行安装。

将存储库克隆到本地后，使用以下命令在终端中打开目录。

cd telegram-phone-number-checker

这应该会在您的终端中打开该目录。要验证，请输入“ls”命令以列出您所在目录中的文件。如果成功，它应该看起来像这样。

jakecreps@Macbook telegram-phone-number-checker % ls
LICENSE                requirements-dev.txt
README.md            requirements.txt
poetry.lock            telegram_phone_number_checker
pyproject.toml            tests

现在您已将项目下载到本地，我们需要安装依赖项。

您会注意到目录中有一个 requirements.txt 文件。使用此文件，我们将使用以下命令来安装要求。

pip install -r requirements.txt

🗒️ 如果您不熟悉命令行工具，这可能会引发错误并显示类似“pip 未安装”的内容。由于每台设备都不同，我建议使用 ChatGPT 进行调试以解决问题。

获取 Telegram API 密钥

此工具需要 Telegram API 密钥才能工作。获取 Telegram API 密钥是免费的。要开始使用，请前往 Telegram并使用有效电话号码创建一个帐户（如果您还没有帐户）。

🗒️ 我建议使用临时电话号码；不过，您的个人设备也可以。只需记住，有人可能会用您的电话号码使用此工具。

创建帐户后，转到应用程序部分。在这里，您可以创建一个新应用程序，它将为您提供 API 密钥和哈希。

成功创建应用程序后，它看起来应该像这样（减去黑色区域）。

我们将使用 App api_id 和 App api_hash 来完成电报电话号码检查器的配置。

应用 API 密钥和哈希

您可以使用以下命令测试该应用程序。

cd telegram-phone-number-checker/telegram-phone-number-checker # To open the directory and the folder the main script is in
python main.py # To run the script

您会注意到，它会立即询问您的 app_id 和 app_hash。如果您经常使用此工具，它每次都会询问您这些内容。这可能会很耗时，让您不想使用该工具。

为了防止这种情况每次都发生，GitHub ReadMe 上有一条说明：

将这些值.env与您的 Telegram 帐户的电话号码一起放在一个文件中：

API_ID=
API_HASH=
PHONE_NUMBER=

对于不熟悉.env文件的人来说，这可能是一个令人困惑的步骤。为了简化这一步骤，以下是您需要了解的所有内容。

如果您使用的是Windows ，请在与 main.py 相同的目录中输入以下命令。

echo API_ID=your_api_id >> .env
echo API_HASH=your_api_hash >> .env
echo PHONE_NUMBER=your_phone_number >> .env

🗒️ 将your_api_id替换为您在 Telegram 中的 id；将your_api_hash也替换为同样的方法；最后，将your_phone_number替换为您在 Telegram 上注册的电话号码。

如果你使用的是Mac/Linux ，请在与 main.py 相同的目录中输入以下命令。唯一的区别是引号。

echo "API_ID=your_api_id" >> .env
echo "API_HASH=your_api_hash" >> .env
echo "PHONE_NUMBER=your_phone_number" >> .env

这应该会创建您的 .env 文件，允许 telegram-phone-number-checker 自动应用您的凭据而不是提示您。

如果您再次运行main.py，它将自动应用这些凭据。

🗒️ 您可能会被提示输入 Telegram 的代码。该代码不会通过短信发送。您必须打开 Telegram 应用才能获取代码。

如果成功，您应该会看到类似这样的内容。

jakecreps@Macbook telegram_phone_number_checker % python main.py 
Logging in...Done.
Enter the phone numbers to check, separated by commas: 

⬇️现在让我们开始使用。

Telegram-phone-number-checker 允许您按单个电话号码或电话号码列表进行搜索。要输入单个电话号码，请输入以下命令，并将占位符电话号码替换为您调查的电话号码。

python main.py --phone-numbers +1234567890

🗒️不要忘记国家代码。

相关：https://github.com/bellingcat/telegram-phone-number-checker

设置——隐私与安全——手机号码——谁能通过我的手机号找到我——改成我的联系人。【ps：开启私聊还不是联系人，联系人需要自己手动添加】

手机客户端——隐私与安全设置，建议清空云端通讯录，关闭同步通讯录。