DMI TCAT

数字方法倡议推特捕获与分析工具集（DMI-TCAT）允许用户检索和收集推特上的推文，并以多种方式进行分析。

安装

详细的安装说明请参阅维基

系统要求

• Twitter API 凭证（可从 https://apps.twitter.com 获取）
• 以下 Linux 发行版之一：
  • Ubuntu 18.04
  • Debian 9.*
• ...或 Docker（实验性）

Debian 和 Ubuntu

运行：

curl https://raw.githubusercontent.com/digitalmethodsinitiative/dmi-tcat/master/helpers/tcat-install-linux.sh | sudo bash

Docker

我们最新的 Docker 镜像可在 Docker Hub 获取。

1. 安装 Docker Desktop 并启动。请注意，在 Windows 上，你可能需要确保在 Docker 中启用了 WSL（适用于 Linux 的 Windows 子系统）集成。你可以在 Docker 设置的 Settings -> Resources -> WSL Integration -> Enable integration with required distros 中找到此选项。

基本安装

2. 运行命令 docker run --publish 80:80 --volume tcat_data:/var/lib/mysql/ --detach --name tcat digitalmethodsinitiative/tcat:1.0，Docker 将下载版本 1.0（或你替换“1.0”的任何标签）。

• --publish HOST_PORT:80 允许你定义主机网络上使用的端口。如果你使用不同的端口，可能还需要添加 -e SERVERNAME=localhost:HOST_PORT，其中 HOST_PORT 是所需端口，因为该端口用于 TCAT 界面中的内部链接。
• --volume volume_name:/var/lib/mysql/ 确保你能够轻松重用 TCAT 的 MySQL 数据库，并在停止使用 TCAT 后恢复数据。

3. 通过 Docker 界面或命令行 docker logs tcat 打开日志以获取登录信息（安装可能需要一些时间，你可以等待或运行 docker logs -f tcat 实时查看）。
4. 在浏览器中打开 http://localhost:80，通过提供你的 Twitter API 信息 以及你想执行的推文捕获类型来完成配置。
5. 恭喜！你可以使用 admin 菜单创建你的第一个推文捕获容器。
6. 将来，你可以通过以下命令停止和启动 TCAT 容器： docker stop tcat 和 docker start tcat

针对你自己的服务器进行定制

Docker 安装还允许你轻松地将 TCAT 托管在服务器上。除了 SERVERNAME 环境变量外，你还可以通过添加 -e LETSENCRYPT=y 和 -e [email protected] 来使用 Let's Encrypt。你还应该开放端口 443 以便 Let's Encrypt 正常工作。你的完整命令可能如下所示： docker run --publish 80:80 --publish 443:443 --volume tcat_data:/var/lib/mysql/ --detach --name tcat -e SERVERNAME=my.website.com -e LETSENCRYPT=y -e [email protected] digitalmethodsinitiative/tcat:1.0

进一步的 TCAT 定制

最后，如果你想自行开发 TCAT，可以克隆此仓库并创建你自己的镜像。

1. 克隆此仓库 git clone https://github.com/digitalmethodsinitiative/dmi-tcat.git
2. 构建镜像（从你克隆 TCAT 的目录中执行）： docker image build --progress=plain -t tcat:1.0 .
3. 在上述 docker run 命令中，将 digitalmethodsinitiative/tcat:1.0 替换为 tcat:1.0

问题反馈

请在报告问题和错误时使用问题模板。

状态

用来描述我们资源有限的一种委婉说法

贡献

我们欢迎各种建议和改进。

许可证

Apache 许可证 2.0 版