启动框架

EFB 提供了两种方法来启动框架：

• ehforwarderbot

• python3 -m ehforwarderbot

两个命令的功能及用法完全一致，运行相同的代码。后者只是一个备份，以防前者不起作用。

选项

• -h, --help：显示帮助信息

• -p PROFILE, --profile PROFILE: 切换配置档案

  从 2.0 版本开始，EFB 支持在同一用户下运行多个实例（根据配置档案进行区分）。默认的配置档案名称为 default 。

• -V, --version: 打印版本信息

  显示您的 Python、EFB 框架、以及所有已启用的信道和中间件的版本号。

• -v, --verbose: 打印详细日志

  开启该选项会记录 EFB 及所有已启用的模块的详细日志。该选项和 --version 一同，对于调试及问题反馈有着极大帮助。

• --trace-threads：跟踪阻塞线程

  当您遇到必须强制退出 EFB 的情况时，此选项可用于确定问题的来源。启用此选项后，在发送第一个停止信号（SIGINT 或 SIGTERM）之后，将会每 10 秒识别一次休眠中的线程，直到收到下一个停止信号。

  要使用此选项，您需要使用以下命令来安装额外的 Python 依赖关系。

  pip3 install 'ehforwarderbot[trace]'
  

退出 EFB

如果您在 shell 中启动了 EFB， 您可以简单地通过 Control-c 来触发退出流程。否则，请使用您的服务管理器发送 SIGTERM 信号。完全退出进程可能会耗时数秒种。

重要

使用优雅终止信号（例如 SIGTERM）十分重要。请不要使用 SIGKILL，否则可能会导致数据丢失或程序异常。

如果您在退出 EFB 时遇到任何问题，请连按五次 Control-c 触发强制退出。如果您经常遇到必须强制退出 EFB 的情况，则表明 EFB 或任何使用中的组件可能正在发生故障。您可能需要使用上文中的 --trace-threads 选项来确定问题的根源，并向相关开发者报告。