twweb 0.6.1

屏幕截图

快速测试

通过运行开发服务器，您可以快速检查twweb是否适合您的需要 在您的计算机上本地。

$ tox -e dev

运行此命令后，可以在localhost:5000上访问twweb。你 可以这样更改开发服务器侦听的端口：

$ tox -e dev -- --port=3333

使用Docker安装

twweb提供了一个docker图像。您可以快速构建容器并运行 这样的图像：

# docker build . -t twweb
# docker run -p 5456:5456 twweb

之后，您应该可以在浏览器中打开twweb的地址 localhost:5456。映像保留^{tt3}内的所有数据和配置$ 目录，因此最好将其作为卷装入：

# docker run -v data:/data -p 5456:5456 twweb

Docker映像将用twweb的设置预先填充/data，只要 找不到配置文件。其他设置（uwsgi配置和 当/data作为主机目录装入时，不会预先填充taskrc）。

在使用以下环境首次运行之前，可以更改设置 变量（与其默认值一起列出）：

• TWWEB_SETTINGS[/data/twweb.cfg]：twweb配置文件的路径。
• TWW_CFG_SECRET[空]：twweb用于加密的密钥。如果这是 空，图像将在第一次运行时生成随机机密。把它空着放进去 大多数情况下。
• TWW_CFG_PIN[twweb]：用于注册第一个用户的pin。你 可能应该更改它
• TWW_CFG_DB_ENGINE[sqlite]
• TWW_CFG_DB_HOST[/data/twweb.db]
• TWW_CFG_TW_TASKRC[/data/taskrc]

示例：

# docker run -v data:/data -p 5456:5456 \
            -e TWW_CFG_SECRET=extraSecret1122 \
            -e TWW_CFG_PIN=supersecret \
            twweb

您也可以通过Docker合成来构建和运行图像。

手动安装

要安装twweb，需要一个能够运行python应用程序的web服务器。 您还需要一个数据库，但是sqlite应该很好，因为twweb不存储 很多。显然你还需要一个工作任务战士。

我们将在virtualenv中安装所有必需的组件。在你开始之前，你 应该选择并创建将放置twweb的目录。暂时 我们假设/var/www/example.com/twweb，其中“example.com”部分是 通常替换为域的名称。

$ sudo mkdir -p /var/www/example.com/twweb
$ sudo chown $USER:www-data /var/www/example.com/twweb
$ chmod 775 /var/www/example.com/twweb
$ cd /var/www/example.com/twweb

以上命令为twweb目录创建并设置适当的权限。 当遵循这种安装方法时，twweb本身将需要编写 此目录中的权限，因此我们将组权限更改为 rwx。

$ sudo apt install task

$ mkdir -m 775 task && chown $USER:www-data task
$ echo "data.location=`pwd`/task" > taskrc

$ virtualenv -p python3 venv
$ venv/bin/pip install twweb uwsgi
$ inst=`find venv -name twweb -type d`

SECRET_KEY = 'this should be secret and complex'
PIN = 'additional password used for first register'

DB_ENGINE = 'sqlite'
DB_HOST = '/var/www/example.com/twweb/twweb.db'

TW_TASKRC = '/var/www/example.com/twweb/taskrc'

$ export TWWEB_SETTINGS=`pwd`/twweb.cfg

location /update {
  include uwsgi_params;
  uwsgi_pass unix:/run/uwsgi/twweb.socket
}