「Wallabag」の版間の差分

提供: ArchWiki
ナビゲーションに移動 検索に移動
(一部飜訳)
(飜訳)
4行目: 4行目:
 
== インストール ==
 
== インストール ==
   
Install the {{Pkg|wallabag}} package.
+
{{Pkg|wallabag}} パッケージをインストールします。
   
 
== 設定 ==
 
== 設定 ==
10行目: 10行目:
 
=== PHP ===
 
=== PHP ===
   
A list of required php modules can be found [https://doc.wallabag.org/en/admin/installation/requirements.html#php-extensions here]. The following snippet is provided for brevity.
+
必要な php モジュールのリストは、[https://doc.wallabag.org/en/admin/installation/requirements.html#php-extensions ここ]にあります。以下のスニペットは簡潔にするために提供されています。
   
 
{{hc|/etc/php/conf.d/wallabag.ini|2=
 
{{hc|/etc/php/conf.d/wallabag.ini|2=
31行目: 31行目:
 
=== Wallabag ===
 
=== Wallabag ===
   
  +
wallabag が適切に設定されたら、データベースとアプリケーションの状態を初期化するために、コマンドを実行する必要があります。
Once wallabag has been properly configured, commands must be run in order to initialise the database and application state.
 
   
  +
{{Tip|コマンドに {{ic|1=--env=prod}} を追加して、目的の環境が設定されていることを確認します。}}
{{Tip|Ensure the desired environment is set by appending {{ic|1=--env=prod}} to the commands.}}
 
 
{{bc|1=
 
{{bc|1=
 
<nowiki>
 
<nowiki>
42行目: 42行目:
 
}}
 
}}
   
{{Note|When changes are made to {{ic|/etc/wallabag/parameters.yml}}, the cache must be cleared.}}
+
{{Note|{ic|/etc/wallabag/parameters.yml}} に変更を加えた場合、キャッシュをクリアする必要があります。}}
   
== Database ==
+
== データベース ==
   
  +
サポートされているデータベースは以下の通りです。
Supported databases are:
 
   
  +
* [[SQLite]] (開発専用。本番環境でのデータベースマイグレーションはサポートされていません。)
* [[SQLite]] (for development only, database migrations are not supported in production.)
 
 
* [[PostgreSQL]]
 
* [[PostgreSQL]]
 
* [[MariaDB]]
 
* [[MariaDB]]
   
  +
セットアップや設定方法については、ここでは触れません。
The setup and configuration are not covered here.
 
   
 
== アプリケーションサーバー ==
 
== アプリケーションサーバー ==
58行目: 58行目:
 
=== php-fpm ===
 
=== php-fpm ===
   
It is recommended to make a copy of {{ic|/etc/php/php-fpm.d/www.conf}} and modify that.
+
{{ic|/etc/php/php-fpm.d/www.conf}} をコピーして、それを修正することをお勧めします。
   
 
{{hc|/etc/php/php-fpm.d/wallabag.conf|2=
 
{{hc|/etc/php/php-fpm.d/wallabag.conf|2=
71行目: 71行目:
 
=== nginx ===
 
=== nginx ===
   
The below configuration is sourced from upstream [https://doc.wallabag.org/en/admin/installation/virtualhosts.html#configuration-on-nginx documentation] and slightly amended:
+
以下の設定は、アップストリームの[https://doc.wallabag.org/en/admin/installation/virtualhosts.html#configuration-on-nginx ドキュメント]から引用し、少し修正したものです。
   
 
{{hc|/etc/nginx/example.conf|2=
 
{{hc|/etc/nginx/example.conf|2=
113行目: 113行目:
 
}}
 
}}
   
Generic configuration for other web servers can be found [https://doc.wallabag.org/en/admin/installation/virtualhosts.html upstream].
+
他のウェブサーバーに関する一般的な設定は、[https://doc.wallabag.org/en/admin/installation/virtualhosts.html 上流]で見つけることができます。
   
 
== トラブルシューティング ==
 
== トラブルシューティング ==
119行目: 119行目:
 
=== バージョン間のアップグレード ===
 
=== バージョン間のアップグレード ===
   
  +
新旧のバージョンに応じて、アップグレードの[https://doc.wallabag.org/en/admin/upgrade.html 手順]が用意されています。一般に、設定セクションに示すように、キャッシュのクリーニングとデータベースの移行を実行する必要があります。
There are upgrade [https://doc.wallabag.org/en/admin/upgrade.html instructions] available, dependent on the old and new versions. Generally, cache must be cleaned and database migrations performed, as shown in the configuration section.
 
   
 
== 参照 ==
 
== 参照 ==

2022年8月2日 (火) 14:06時点における版

wallabag は、Web ページを保存するためのセルフホスト可能なアプリケーションです。

インストール

wallabag パッケージをインストールします。

設定

PHP

必要な php モジュールのリストは、ここにあります。以下のスニペットは簡潔にするために提供されています。

/etc/php/conf.d/wallabag.ini
extension=bcmath
extension=gd
extension=gettext
extension=iconv
extension=intl
extension=tidy

; database - sqlite
;extension=pdo_sqlite
;extension=sqlite3

; database - pgsql
;extension=pdo_pgsql
;extension=pgsql

Wallabag

wallabag が適切に設定されたら、データベースとアプリケーションの状態を初期化するために、コマンドを実行する必要があります。

ヒント: コマンドに --env=prod を追加して、目的の環境が設定されていることを確認します。
# cd /usr/share/wallabag
# sudo -u wallabag php bin/console cache:clear
# sudo -u wallabag php bin/console doctrine:migrations:migrate
ノート: {ic

に変更を加えた場合、キャッシュをクリアする必要があります。}}

データベース

サポートされているデータベースは以下の通りです。

  • SQLite (開発専用。本番環境でのデータベースマイグレーションはサポートされていません。)
  • PostgreSQL
  • MariaDB

セットアップや設定方法については、ここでは触れません。

アプリケーションサーバー

php-fpm

/etc/php/php-fpm.d/www.conf をコピーして、それを修正することをお勧めします。

/etc/php/php-fpm.d/wallabag.conf
[wallabag]

user = wallabag
group = wallabag

ウェブサーバー

nginx

以下の設定は、アップストリームのドキュメントから引用し、少し修正したものです。

/etc/nginx/example.conf
server {
  root /usr/share/wallabag/web;
  
  # When you want to import large files into wallabag, you need to add this line.
  client_max_body_size XM; # allows file uploads up to X megabytes.

  location / {
    # try to serve file directly, fallback to app.php
    try_files $uri /app.php$is_args$args;
  }
  location ~ ^/app\.php(/|$) {
    fastcgi_pass unix:/run/php-fpm/php-fpm.sock;
    fastcgi_split_path_info ^(.+\.php)(/.*)$;
    include fastcgi_params;
    # When you are using symlinks to link the document root to the
    # current version of your application, you should pass the real
    # application path instead of the path to the symlink to PHP
    # FPM.
    # Otherwise, PHP's OPcache may not properly detect changes to
    # your PHP files (see https://github.com/zendtech/ZendOptimizerPlus/issues/126
    # for more information).
    fastcgi_param  SCRIPT_FILENAME  $realpath_root$fastcgi_script_name;
    fastcgi_param DOCUMENT_ROOT $realpath_root;
    # Prevents URIs that include the front controller. This will 404:
    # http://domain.tld/app.php/some-path
    # Remove the internal directive to allow URIs like this
    internal;
  }

  # return 404 for all other php files not matching the front controller
  # this prevents access to other php files you don't want to be accessible.
  location ~ \.php$ {
    return 404;
  }
}

他のウェブサーバーに関する一般的な設定は、上流で見つけることができます。

トラブルシューティング

バージョン間のアップグレード

新旧のバージョンに応じて、アップグレードの手順が用意されています。一般に、設定セクションに示すように、キャッシュのクリーニングとデータベースの移行を実行する必要があります。

参照