Tự lưu trữ TAGUETTE
Taguette có thể chạy theo 2 cách riêng biệt:
- Trên máy tính, sau khi cài đặt. Điều nay không đòi hỏi thao tác gì phức tạp, và dữ liệu của bạn sẽ không bao giờ rời khỏi máy của bạn!
- Trên server. Điều này khó thiết lập hơn, nhưng sau đó người dùng có thể sử dụng phiên bản đã cài đặt đó mà không cần gì khác ngoài trình duyệt Web của họ! Chúng tôi lưu trữ một máy chủ Taguette có sẵn công khai tại app.taguette.org tại thời điểm này, vì vậy bạn có thể thoải mái sử dụng nó. Nếu bạn muốn triển khai máy chủ của riêng mình cho tổ chức của mình, hãy đọc tiếp!
Sử dụng Docker
Nếu chọn cách này, bạn có thể chạy quay.io/remram44/taguette
hình ảnh Docker . Bạn sẽ được nhắc nhập mật khẩu 'quản trị viên' lần đầu tiên. Bạn có thể duy trì dữ liệu bằng cách gắn một ổ đĩa trên/data
, như này:
docker run --rm quay.io/remram44/taguette default-config >/srv/taguette/config.py edit /srv/taguette/config.py # Edit configuration file, see below docker run -ti -p 80:7465 -v /srv/taguette:/data --restart=always quay.io/remram44/taguette server /data/config.py
Nếu muốn sử dụng docker-compose, bạn có thể thay thế dòng lệnh cuối cùng (sau khi đã thiết lập file cấu hình) từ docker-compose up
, sang docker-compose.yml
như:
version: "2.4" services: taguette: image: quay.io/remram44/taguette command: ["server", "/config.py"] ports: ["127.0.0.1:7465:7465"] volumes: - "./config.py:/config.py:ro" - "./data:/data"
Cài đặt "Gốc" trên máy chủ
Bạn cần phiên bản Python 3.5 trở lên để chạy Taguette. Chạy pip install taguette
để cài đặt phần mềm này. Để nhập được các tài liệu phi HTML, bạn cần cài Calibre (đặc biệt là phần lệnhebook-convert
).
Sử dụng một môi trường ảo được khuyến khích. Ví dụ cài đặt trên Ubuntu:
apt update apt install calibre python3.5 virtualenv virtualenv --python=python3.5 /srv/taguette . /srv/taguette/bin/activate pip install taguette taguette default-config >config.py edit config.py # Edit configuration file, see below taguette --no-browser server config.py
Tệp cấu hình
Trong cả hai trường hợp, việc chạy máy chủ yêu cầu tệp cấu hình. Tệp này chứa thông tin quan trọng, chẳng hạn như máy chủ email và địa chỉ, số cổng để nghe, cơ sở dữ liệu nào sẽ sử dụng, đăng ký tài khoản mới có được bật hay không, v.v...
Bạn có thể làm cho Taguette in một tệp cấu hình để bạn chỉnh sửa bằng cách sử dụng taguette default-config
.
Bạn có thể thay PORT
sang80
, hoặc tốt hơn là định cấu hình máy chủ web để hoạt động như một proxy, xem bên dưới.
Sử dụng máy chủ proxy
Vì lý do hiệu suất hoặc bảo mật hoặc đơn giản là vì bạn muốn lưu trữ nhiều trang web trên máy của mình, bạn có thể muốn đặt một máy chủ web (như nginx hay Apache) trước Taguette. Máy chủ này Sau đó, máy chủ đó sẽ chỉ chuyển tiếp các kết nối tới Taguette (một thiết lập mà chúng tôi gọi là Proxy ngược). Bạn có thể sử dụng nó để cung cấp mã hóa bằng TLS (được khuyến nghị) chẳng hạn bằng cách sử dụng Let's Encrypt, miễn phí.
Để trợ giúp việc này, chúng tôi cung cấp tệp cấu hình mẫu để bạn có thể sử dụng.
Cơ sở dữ liệu
The DATABASE
setting should be a SQLAlchemy connection string. For example, you can use:
- a SQLite database file (note the 4 slashes):
sqlite:////srv/taguette/taguette.sqlite3
- a PostgreSQL database (or compatible, e.g. YugabyteDB):
postgresql://user:secretpassword@localhost/taguette
(you need topip install psycopg2-binary
) - a MariaDB database (MySQL currently doesn't work):
mysql+pymysql://user:secretpassword@localhost/taguette
(you need topip install pymysql cryptography
) - ... or any of the other databases supported by SQLAlchemy. Note that we don't test any other database, so you might run into issues.