Funkwhale - 版の履歴

Kgx: /* Troubleshooting */ 翻訳

2024-01-16T20:01:59Z

Troubleshooting: 翻訳

← 古い版		2024年1月17日 (水) 05:01時点における版
233行目:		233行目:
	{{note\|バージョン 1.3.0 より前では、AUR パッケージはアップストリームと同様に {{ic\|funkwhale.target}} を使用した後、{{ic\|funkwhale.service}} を使用していました。}}		{{note\|バージョン 1.3.0 より前では、AUR パッケージはアップストリームと同様に {{ic\|funkwhale.target}} を使用した後、{{ic\|funkwhale.service}} を使用していました。}}

			== トラブルシューティング ==
	== Troubleshooting ==

	~~See~~ https://docs.funkwhale.audio/admin/troubleshooting.html		https://docs.funkwhale.audio/admin/troubleshooting.html を参照してください。

	=== ~~Proxy logs~~ ===		=== プロキシログ ===

			funkwhale の Apache ログ:
	Apache logs for funkwhale:

	$ tail -f /var/log/httpd/funkwhale/error.log		$ tail -f /var/log/httpd/funkwhale/error.log

Kgx: /* Usage */ 翻訳

2024-01-16T20:00:45Z

Usage: 翻訳

← 古い版		2024年1月17日 (水) 05:00時点における版
221行目:		221行目:
	{{Note\|アップグレードの手順はすべて、公式ドキュメント [https://docs.funkwhale.audio/upgrading/index.html] に記載されています。}}		{{Note\|アップグレードの手順はすべて、公式ドキュメント [https://docs.funkwhale.audio/upgrading/index.html] に記載されています。}}

	== ~~Usage~~ ==		== 使い方 ==

			アップストリームは、AUR パッケージとともにすでにインストールされている systemd サービスを提供します。
	Upstream provides systemd services that are already installed with the AUR package.

			インスタンスを開始するには、{{ic\|funkwhale.target}} を [[起動]] するだけです。
	To start the instance, just [[start]] {{ic\|funkwhale.service}}.

			これにより 3 つのサービスが開始され、次のコマンドでステータスを確認できます:
	This starts three services, you can check their status with:

	$ systemctl status funkwhale-\*		$ systemctl status funkwhale-\*

			{{note\|バージョン 1.3.0 より前では、AUR パッケージはアップストリームと同様に {{ic\|funkwhale.target}} を使用した後、{{ic\|funkwhale.service}} を使用していました。}}

	== Troubleshooting ==		== Troubleshooting ==

Kgx: /* Version upgrade */ 翻訳

2024-01-16T19:58:38Z

Version upgrade: 翻訳

← 古い版		2024年1月17日 (水) 04:58時点における版
185行目:		185行目:
	}}		}}

			== バージョンアップ ==
	== Version upgrade ==

			=== 自動 ===
	{{note\|Starting with version 0.21, an alias is provided for {{ic\|/usr/share/webapps/funkwhale/api/manage.py}} in {{ic\|/usr/bin/funkwhale_manage}}, so you can use:

			AUR から {{AUR\|funkwhale-venv}} をインストールした場合は、特別なことは何もありません。エラーが発生した場合は、{{ic\|/usr/bin/funkwhale_manage}} スクリプトを使用して、{{ic\|/usr/share/webapps/funkwhale/api/manage.py}} コマンドを実行します sudo を使用して (実行する必要があります))
⚫	[funkwhale]$ funkwhale_manage ~~[commands...]~~

	instead of

	[funkwhale]$ python /usr/share/webapps/funkwhale/api/manage.py [commands...]

			{{Warning\|
			* サービスを再起動する前に、Apache または nginx の設定ファイルが変更されていないことを確認してください。互換性のない変更については、公式ドキュメントを参照してください。
	}}		}}

			=== マニュアル ===
	All commands should be entered as {{ic\|funkwhale}} [[#Funkwhale user\|user]].
	[[Stop]] the {{ic\|funkwhale.service}} before upgrading.

			{{note\|バージョン 1.3.0 より前では、AUR パッケージはアップストリームと同様に {{ic\|funkwhale.target}} を使用した後、{{ic\|funkwhale.service}} を使用していました。}}
	The static files have to be collected again:

			AUR から {{AUR\|funkwhale}} をインストールした場合は、次の手順に従ってください。
⚫	[funkwhale]$ funkwhale_manage collectstatic --no-input

			アップグレードする前に、{{ic\|funkwhale.target}} を [[停止]] してください。
	Apply database migrations:

			すべてのコマンドは、{{ic\|funkwhale}} [[Funkwhale# Funkwhale ユーザー\|ユーザー]] として入力する必要があります。
	[funkwhale]$ funkwhale_manage migrate

			静的ファイルを再度収集する必要があります:
	To upgrade to version 1.0, the thumbnails quality has been increased from 70 to 95, so all the thumbnails should be regenerated (or set THUMBNAIL_JPEG_RESIZE_QUALITY=70 in the .env file so nothing changes).
	First delete the {{ic\|__sized__ directory}} in your {{ic\|MEDIA_ROOT}} directory, then regenerate the thumbnails,

		⚫	[funkwhale]$ funkwhale_manage collectstatic --no-input
	[funkwhale]$ rm -rf /srv/funkwhale/data/media/__sized__
	[funkwhale]$ funkwhale_manage fw media generate-thumbnails

			データベース移行を適用します:
	Starting from version 0.20.1, there is a new {{ic\|MUSIC_USE_DENORMALIZATION}} parameter in the {{ic\|env}} file set to {{ic\|True}} (you can set it to {{ic\|False}} so nothing changes). It is a performance enhancement and to make it work you need to run the following command,

		⚫	[funkwhale]$ funkwhale_manage migrate
	[funkwhale]$ python /usr/share/webapps/funkwhale/api/manage.py rebuild_music_permissions

	{{warning\|Check that the apache or nginx configuration file did not change before restarting the service. Consult the official documentation for incompatible changes.}}

	{{warning\|From version 0.20, {{AUR\|python-daphne}} was replaced by {{Pkg\|uvicorn}}/{{Pkg\|gunicorn}}. The service file was updated not to use {{AUR\|python-daphne}} anymore. This can be changed by editing the {{ic\|funkwhale-server.service}} file.
	Also, the {{ic\|citext}} extension for postgresql is now needed. It can be loaded with issueing the following command before calling the {{ic\|migrate}} command:

	{{bc\|$ sudo -u postgres psql funkwhale -c 'CREATE EXTENSION "citext";'}}

			{{Warning\|
			* サービスを再起動する前に、Apache または nginx の設定ファイルが変更されていないことを確認してください。互換性のない変更については、公式ドキュメントを参照してください。
	}}		}}

			これらの手順をすべて完了すると、{{ic\|funkwhale.target}} は再び [[ヘルプ:読み方#systemd ユニットのコントロール\|起動状態]] になります。
	After completing all these steps, the {{ic\|funkwhale.service}} can be [[started]] again.

	{{Note\|~~All the instructions for upgrading are given on the official documentation~~ [https://docs.funkwhale.audio/upgrading/index.html].}}		{{Note\|アップグレードの手順はすべて、公式ドキュメント [https://docs.funkwhale.audio/upgrading/index.html] に記載されています。}}

	== Usage ==		== Usage ==

Kgx: /* Initialization */ 翻訳

2024-01-16T19:50:30Z

Initialization: 翻訳

← 古い版		2024年1月17日 (水) 04:50時点における版
119行目:		119行目:
	これらは funkwhale が動作するために必要です ({{ic\|citext}} バージョン 0.20 以降)		これらは funkwhale が動作するために必要です ({{ic\|citext}} バージョン 0.20 以降)

	== ~~Initialization~~ ==		== 初期化 ==

	=== Funkwhale ~~user~~ ===		=== Funkwhale ユーザー ===

			Funkwhale は、{{ic\|funkwhale}} ユーザーとして実行する必要があります。これは、AUR パッケージによって自動的に作成されます。
	Funkwhale should be run as the {{ic\|funkwhale}} user. It is automatically created by the AUR package.
			手動インストールに従った場合は、次のように作成します。
	If you followed the manual installation, create it with

	$ useradd -r -d /srv/funkwhale -m funkwhale -c "Funkwhale music server -s /sbin/nologin"		# useradd -r -d /srv/funkwhale -m funkwhale -c "Funkwhale music server -s /sbin/nologin"

	~~Create~~ Funkwhale's ~~data folders in~~ {{ic\|/srv/funkwhale}},		Funkwhale のデータフォルダーを {{ic\|/srv/funkwhale}} に作成します。
	~~owned by the~~ {{ic\|funkwhale}} ~~user~~:		{{ic\|funkwhale}} ユーザーが所有:

	$ mkdir /srv/funkwhale		# mkdir /srv/funkwhale
	$ chown funkwhale:funkwhale /srv/funkwhale		# chown funkwhale:funkwhale /srv/funkwhale

			{{ic\|funkwhale}} ユーザーとして次のコマンドを実行します。
	Run the following commands as the {{ic\|funkwhale}} user.

			API ファイルとストレージ用のサブフォルダーを作成します:
	Create sub-folders for api files and storage.

	~~{{hc\|~~$ ~~sudo -u~~ funkwhale ~~-H bash\|2=~~		[funkwhale]$ cd /srv/funkwhale
	[funkwhale]$ cd /~~srv~~/~~funkwhale~~		[funkwhale]$ mkdir -p api data/static data/media data/music config
	[funkwhale]$ mkdir -p api data/static data/media data/music config
⚫	}}

	~~To work,~~ Funkwhale ~~needs several environment variables to be present, these should be defined in the environment file~~ {{ic\|/srv/funkwhale/config/env}}.		Funkwhale が動作するには、いくつかの環境変数が必要です。これらは環境ファイル {{ic\|/srv/funkwhale/config/env}} で定義されている必要があります。
	~~There is a template at~~ {{ic\|/etc/webapps/funkwhale/env.template}}, ~~copy and modify it to fit your installation.~~		{{ic\|/etc/webapps/funkwhale/env.template}} にテンプレートがあります。これをコピーして、インストールに合わせて変更します。

	[funkwhale]$ cp /etc/webapps/funkwhale/env.template /srv/funkwhale/config/env		[funkwhale]$ cp /etc/webapps/funkwhale/env.template /srv/funkwhale/config/env

	~~The~~ {{ic\|FUNKWHALE_HOSTNAME}} ~~variable should correspond to the hostname in~~ {{ic\|/etc/hosts}}.		{{ic\|FUNKWHALE_HOSTNAME}} 変数は、{{ic\|/etc/hosts}} のホスト名に対応する必要があります。
	{{ic\|DJANGO_ALLOWED_HOSTS}} ~~needs also to match the address where the~~ funkwhale ~~instance will be reached.~~		{{ic\|DJANGO_ALLOWED_HOSTS}} も、funkwhale インスタンスに到達するアドレスと一致する必要があります。
			一意の {{ic\|DJANGO_SECRET_KEY}} を生成し、インストールに応じてパスを変更する必要があります。
	You should generate a unique {{ic\|DJANGO_SECRET_KEY}} and change the paths accordingly to your installation.

			{{Tip\|環境変数がロードされた状態で {{ic\|funkwhale}} ユーザーとしていくつかのコマンドを実行する必要があるため、ログイン後に次のコマンドラインを使用できます:
	{{Tip\|As you will need to run several commands as the {{ic\|funkwhale}} user with the environment variables loaded, you can use the following command-line after logging in:

	~~{{ic\|~~[funkwhale]$ export $(~~cat~~ /srv/funkwhale/config/env ~~{{!}} grep -v ^#~~ {{!}} xargs)}}		[funkwhale]$ export $(grep -v ^# /srv/funkwhale/config/env {{!}} xargs)

			便宜上、この行を {{ic\|/srv/funkwhale/.bashrc}} (または使用しているシェル) にコピーすると、funkwhale ユーザーにログインするたびに自動的にロードされます。
	For convenience, you can copy this line to /srv/funkwhale/.bashrc (or whichever shell you are using),
	so it is loaded automatically everytime you log in to the funkwhale user.
	}}		}}

			=== データベースのセットアップ ===
	=== Database setup ===

			AUR から {{AUR\|funkwhale-venv}} をインストールした場合は、{{ic\|/usr/bin/funkwhale_manage}} を使用して {{ic\|/usr/share/webapps/funkwhale/api/manage.py}} を実行します{{ic\|funkwhale}} ユーザーとしてコマンドを実行します。
	Initialize the database before launching the application:

			アプリケーションを起動する前にデータベースを初期化します:
	{{hc\|$ sudo -u funkwhale -H bash\|2=
⚫	[funkwhale]$ python /usr/share/webapps/funkwhale/api/manage.py migrate
	}}

			[funkwhale]$ funkwhale_manage migrate
	Create a superuser for your Funkwhale instance:

			Funkwhale インスタンスのスーパーユーザーを作成します:
⚫	[funkwhale]$ python /usr/share/webapps/funkwhale/api/manage.py createsuperuser

			[funkwhale]$ funkwhale_manage createsuperuser
	Collect the static files for the webapp:

			Web アプリの静的ファイルを収集します:
⚫	[funkwhale]$ python /usr/share/webapps/funkwhale/api/manage.py collectstatic

	{{note\|Starting with version 0.21, an alias is provided for {{ic\|/usr/share/webapps/funkwhale/api/manage.py}} in {{ic\|/usr/bin/funkwhale_manage}}, so you can instead use:
	[funkwhale]$ funkwhale_manage collectstatic		[funkwhale]$ funkwhale_manage collectstatic

			{{Note\|{{ic\|funkwhale_manage}} を使用しない場合は、まず Python virtualenv をアクティブにしてから、{{ic\|funkwhale}} ユーザーとしてコマンドを実行する必要があります。

			{{bc\|
			[funkwhale]$ source /usr/share/webapps/funkwhale/virtualenv/bin/activate
		⚫	[funkwhale]$ python /usr/share/webapps/funkwhale/api/manage.py migrate
		⚫	[funkwhale]$ python /usr/share/webapps/funkwhale/api/manage.py createsuperuser
		⚫	[funkwhale]$ python /usr/share/webapps/funkwhale/api/manage.py collectstatic
			[funkwhale]$ deactivate
		⚫	}}

	}}		}}

Kgx: /* Configuration */ 翻訳

2024-01-16T19:44:46Z

Configuration: 翻訳

← 古い版		2024年1月17日 (水) 04:44時点における版
40行目:		40行目:
	[https://docs.funkwhale.audio/installation/docker.html] にある Docker のインストール手順に従ってください。		[https://docs.funkwhale.audio/installation/docker.html] にある Docker のインストール手順に従ってください。

	== ~~Configuration~~ ==		== 設定 ==

			以下のセクションでは、Funkwhale が AUR からインストールされたことを前提としています。
	The following sections assume that Funkwhale was installed from AUR,
			手動インストールの場合は、フォルダーを適切に変更する必要があります。
	for a manual installation the folders should be changed appropriately.

			また、ローカルネットワーク上で Funkwhale を使用していることも前提としています。
	It also assumes that you are using Funkwhale on a local network.
	~~See the official~~ [https://docs.funkwhale.audio/index.html ~~documentation~~] ~~for making it accessible outside,~~		外部からアクセスできるようにする方法については、公式 [https://docs.funkwhale.audio/index.html ドキュメント] を参照してください。
			特に [[Certbot]] を使用する証明書の場合。
	especially for the certificates using [[Certbot]].

	=== ~~Host config~~ ===		=== ホスト設定 ===

			{{ic\|/etc/hosts}} ファイルが正しく設定されていることを確認してください。
	Make sure your {{ic\|/etc/hosts}} file is setup correctly.
	~~The~~ Funkwhale ~~server is running on~~ {{ic\|127.0.0.1}} ~~with alias~~ {{ic\|funkwhale.local}}, ~~but this can be changed.~~		Funkwhale サーバーは、{{ic\|127.0.0.1}} でエイリアス {{ic\|funkwhale.local}} で実行されていますが、これは変更できます。

	~~Your~~ {{ic\|/etc/hosts}} ~~file should look something like the following,~~		{{ic\|/etc/hosts}} ファイルは次のようになります。

	{{bc\|#<ip-address> <hostname.domain.org> <hostname>		{{bc\|#<ip-address> <hostname.domain.org> <hostname>
61行目:		61行目:
	127.0.0.1 funkwhale.local}}		127.0.0.1 funkwhale.local}}

	=== ~~Configure~~ nginx ===		=== nginx の設定 ===

	~~The upstream template of the~~ Nginx ~~configuration file is provided in~~ {{ic\|/etc/webapps/funkwhale/nginx.template}}.		Nginx 構成ファイルのアップストリームテンプレートは、{{ic\|/etc/webapps/funkwhale/nginx.template}} で提供されます。
			ただし、このファイルには、{{ic\|env}} ファイルの値で置き換える必要がある変数が含まれています
	However, this file contains variables that need to be replaced by their value from the {{ic\|env}} file
			(このファイルの作成方法についてはセクション [[Funkwhale#初期化\|初期化]] を参照してください):
	(see section [[#Initialization]] on how to create this file):

	$ set -a && source /srv/funkwhale/config/env && set +a		$ set -a && source /srv/funkwhale/config/env && set +a
72行目:		72行目:
	> /etc/nginx/sites-available/funkwhale.conf		> /etc/nginx/sites-available/funkwhale.conf

			証明書へのパスもそれに応じて変更する必要があります。
	The paths to the certificates should also be modified accordingly.

			次に、サイトを有効にします:
	Then enable the site:

	$ ln -s /etc/nginx/sites-available/funkwhale.conf /etc/nginx/sites-enabled/		$ ln -s /etc/nginx/sites-available/funkwhale.conf /etc/nginx/sites-enabled/

	~~And [[start]] the~~ {{ic\|nginx.service}}.		そして、{{ic\|nginx.service}} を [[起動]] します。

	=== ~~Configure~~ ~~apache~~ ===		=== Apache の設定 ===

			{{note\|[[Redis]]、[[PostgreSQL]]、および Apache [[TLS]] サポートを使用して実行するように [[Apache HTTP Server]] を設定する必要があります。}}
	{{note\|You will need [[Apache HTTP Server]] configured to run with [[Redis]], [[PostgreSQL]] and Apache [[TLS]] support.}}

	~~A template~~ Apache ~~configuration file is provided in~~ {{ic\|/etc/webapps/funkwhale/apache-funkwhale.conf}}~~. It configures the~~ Funkwhale ~~instance to be accessible at~~ {{ic\|https://funkwhale.local}}.		テンプレートの Apache 設定ファイルは、{{ic\|/etc/webapps/funkwhale/apache-funkwhale.conf}} で提供されます。Funkwhale インスタンスが {{ic\|https://funkwhale.local}} でアクセスできるように設定されます。

	~~The folder names should be change to fit your installation. More explanation on which lines need to be modified is provided in~~ [https://docs.funkwhale.audio/installation/index.html#reverse-proxy-setup].		フォルダー名は、インストールに合わせて変更する必要があります。どの行を変更する必要があるかについての詳細は、[https://docs.funkwhale.audio/installation/index.html#reverse-proxy-setup] で説明されています。

			テンプレートを Apache 設定フォルダーにコピーし、
	Copy the template to the apache configuration folder,

	$ cp /etc/webapps/funkwhale/apache-funkwhale.conf /etc/httpd/conf/extra/funkwhale.conf		$ cp /etc/webapps/funkwhale/apache-funkwhale.conf /etc/httpd/conf/extra/funkwhale.conf

	~~Next, edit the~~ [[Apache HTTP Server]] ~~configuration file and add the following:~~		次に、[[Apache HTTP Server]] 設定ファイルを編集し、以下を追加します。

	{{hc\|# /etc/httpd/conf/httpd.conf\|		{{hc\|# /etc/httpd/conf/httpd.conf\|
98行目:		98行目:
	}}		}}

			変更を適用するには、[[systemd#ユニットを使う\|systemd]] を使用して {{ic\|httpd.service}} (Apache) を再起動する必要があります。
	For the changes to be applied, you need to restart {{ic\|httpd.service}} (Apache) using [[systemd#Using units\|systemd]].

	=== ~~Configure~~ PostgreSQL ===		=== PostgreSQL の設定 ===

	~~Here we follow the official documentation~~: [https://docs.funkwhale.audio/installation/~~external_dependencies~~.html]		ここでは、公式ドキュメントに従います: [https://docs.funkwhale.audio/installation/external_dependency.html]

			{{ic\|postgres}} ユーザーを使用して [[PostgreSQL]] コマンドラインに接続し、{{ic\|funkwhale}} ユーザーとデータベースを作成します。
	Connect to the [[PostgreSQL]] command line using the {{ic\|postgres}} user to create the {{ic\|funkwhale}} user and the database.

	{{hc\|$ sudo -u postgres psql\|2=		{{hc\|$ sudo -u postgres psql\|2=
116行目:		116行目:
	}}		}}

	~~The~~ ~~last three lines load the~~ {{ic\|unaccent}} ~~and~~ {{ic\|citext}} ~~extensions,~~		最後の 3 行は、{{ic\|unaccent}} および {{ic\|citext}} 拡張機能をロードします。
	~~which are needed for~~ funkwhale ~~to work~~ ({{ic\|citext}} ~~since version~~ 0.20).		これらは funkwhale が動作するために必要です ({{ic\|citext}} バージョン 0.20 以降)

	== Initialization ==		== Initialization ==

Kgx: 他言語へのリンクを追加

2024-01-16T19:35:29Z

他言語へのリンクを追加

← 古い版		2024年1月17日 (水) 04:35時点における版
2行目:		2行目:
	[[Category:音楽]]		[[Category:音楽]]
	[[Category:ウェブアプリケーション]]		[[Category:ウェブアプリケーション]]
			[[en:Funkwhale]]
	{{Related articles start}}		{{Related articles start}}
	{{Related\|Django}}		{{Related\|Django}}

Kgx: /* Installation */ 翻訳

2024-01-16T18:41:59Z

Installation: 翻訳

← 古い版		2024年1月17日 (水) 03:41時点における版
16行目:		16行目:
	インスタンスは ActivityPub プロトコルで連携できます。		インスタンスは ActivityPub プロトコルで連携できます。

	== ~~Installation~~ ==		== インストール ==

	Funkwhale ~~requires a reverse proxy~~ ([https://docs.funkwhale.audio/installation/index.html]),		Funkwhale にはリバースプロキシ ([https://docs.funkwhale.audio/installation/index.html]) が必要です。
	so [[nginx]] or [[Apache HTTP Server]] ~~need to be installed.~~		したがって、[[nginx]] または [[Apache HTTP Server]] をインストールする必要があります。

	~~It also needs a configured~~ [[PostgreSQL]] ~~database and a~~ [[Redis]] ~~cache server.~~		また、設定された [[PostgreSQL]] データベースと [[Redis]] キャッシュサーバーも必要です。
			詳細については、[[Funkwhale#設定]] およびそれぞれのページを参照してください。
	See [[#Configuration]] and the respective pages for information.

			=== AUR からのインストール ===
	=== Installation from AUR ===

			{{AUR\|funkwhale}} パッケージを [[インストール]] して下さい。
	[[Install]] the {{AUR\|funkwhale}} package.

			{{warning\|このインストールでは Python virtualenv を使用しないため、すべての Python 依存関係は主に AUR からシステム全体にインストールされます。パッケージのバージョンが上流の要件と異なる場合があり、問題が発生する可能性があります。}}
	{{warning\|This installation does not use a python virtualenv, so all the python dependencies are installed system-wide, mainly from the AUR. Package versions may differ from the upstream requirements and cause problems.}}

	=== ~~Manual install~~ ===		=== 手動インストール ===

	~~Follow instructions for the Arch installation at~~ [https://docs.funkwhale.audio/installation/debian.html].		[https://docs.funkwhale.audio/installation/debian.html] にある Arch のインストール手順に従ってください。
			これにより、すべてのコンポーネントが {{ic\|/srv/funkwhale}} にインストールされます。
	This will install all components in {{ic\|/srv/funkwhale}}.

	=== Docker ~~install~~ ===		=== Docker のインストール ===

	~~Follow instructions for the Docker installation at~~ [https://docs.funkwhale.audio/installation/docker.html].		[https://docs.funkwhale.audio/installation/docker.html] にある Docker のインストール手順に従ってください。

	== Configuration ==		== Configuration ==

2024年1月16日 (火) 18:38にKgxによる

2024-01-16T18:38:13Z

← 古い版		2024年1月17日 (水) 03:38時点における版
11行目:		11行目:
	{{Related\|PostgreSQL}}		{{Related\|PostgreSQL}}
	{{Related articles end}}		{{Related articles end}}
	Music
	[https://docs.funkwhale.audio/index.html メインドキュメントページ]: から引用		[https://docs.funkwhale.audio/index.html メインドキュメントページ]: から引用
	:[https://funkwhale.audio/ Funkwhale] is a self-hosted, modern, free and open-source music server, heavily inspired by Grooveshark.		:[https://funkwhale.audio/ Funkwhale] is a self-hosted, modern, free and open-source music server, heavily inspired by Grooveshark.

Kgx: 序文を翻訳

2024-01-16T18:37:42Z

序文を翻訳

← 古い版		2024年1月17日 (水) 03:37時点における版
12行目:		12行目:
	{{Related articles end}}		{{Related articles end}}
	Music		Music
	~~Quoting the~~ [https://docs.funkwhale.audio/index.html ~~main documentation page~~]:		[https://docs.funkwhale.audio/index.html メインドキュメントページ]: から引用
	:[https://funkwhale.audio/ Funkwhale] is a self-hosted, modern, free and open-source music server, heavily inspired by Grooveshark.		:[https://funkwhale.audio/ Funkwhale] is a self-hosted, modern, free and open-source music server, heavily inspired by Grooveshark.

			インスタンスは ActivityPub プロトコルで連携できます。
	Instances can be federated via the ActivityPub protocol.

	== Installation ==		== Installation ==

Kusanaginoturugi: 英語版より記事を転載

2022-01-22T04:55:49Z

英語版より記事を転載

新規ページ

[[Category:メディアサーバー]]
[[Category:音楽]]
[[Category:ウェブアプリケーション]]
{{Related articles start}}
{{Related|Django}}
{{Related|Apache HTTP Server}}
{{Related|Nginx}}
{{Related|OpenSSL}}
{{Related|Certbot}}
{{Related|Redis}}
{{Related|PostgreSQL}}
{{Related articles end}}
Music
Quoting the [https://docs.funkwhale.audio/index.html main documentation page]:
:[https://funkwhale.audio/ Funkwhale] is a self-hosted, modern, free and open-source music server, heavily inspired by Grooveshark.

Instances can be federated via the ActivityPub protocol.

== Installation ==

Funkwhale requires a reverse proxy ([https://docs.funkwhale.audio/installation/index.html]),
so [[nginx]] or [[Apache HTTP Server]] need to be installed.

It also needs a configured [[PostgreSQL]] database and a [[Redis]] cache server.
See [[#Configuration]] and the respective pages for information.

=== Installation from AUR ===

[[Install]] the {{AUR|funkwhale}} package.

{{warning|This installation does not use a python virtualenv, so all the python dependencies are installed system-wide, mainly from the AUR. Package versions may differ from the upstream requirements and cause problems.}}

=== Manual install ===

Follow instructions for the Arch installation at [https://docs.funkwhale.audio/installation/debian.html].
This will install all components in {{ic|/srv/funkwhale}}.

=== Docker install ===

Follow instructions for the Docker installation at [https://docs.funkwhale.audio/installation/docker.html].

== Configuration ==

The following sections assume that Funkwhale was installed from AUR,
for a manual installation the folders should be changed appropriately.

It also assumes that you are using Funkwhale on a local network.
See the official [https://docs.funkwhale.audio/index.html documentation] for making it accessible outside,
especially for the certificates using [[Certbot]].

=== Host config ===

Make sure your {{ic|/etc/hosts}} file is setup correctly.
The Funkwhale server is running on {{ic|127.0.0.1}} with alias {{ic|funkwhale.local}}, but this can be changed.

Your {{ic|/etc/hosts}} file should look something like the following,

{{bc|#<ip-address> <hostname.domain.org> <hostname>
127.0.0.1 localhost
::1 localhost
127.0.0.1 funkwhale.local}}

=== Configure nginx ===

The upstream template of the Nginx configuration file is provided in {{ic|/etc/webapps/funkwhale/nginx.template}}.
However, this file contains variables that need to be replaced by their value from the {{ic|env}} file
(see section [[#Initialization]] on how to create this file):

$ set -a && source /srv/funkwhale/config/env && set +a
$ envsubst "`env | awk -F = '{printf \" $%s\", $$1}'`" \
< /etc/webapps/funkwhale/nginx.conf \
> /etc/nginx/sites-available/funkwhale.conf

The paths to the certificates should also be modified accordingly.

Then enable the site:

$ ln -s /etc/nginx/sites-available/funkwhale.conf /etc/nginx/sites-enabled/

And [[start]] the {{ic|nginx.service}}.

=== Configure apache ===

{{note|You will need [[Apache HTTP Server]] configured to run with [[Redis]], [[PostgreSQL]] and Apache [[TLS]] support.}}

A template Apache configuration file is provided in {{ic|/etc/webapps/funkwhale/apache-funkwhale.conf}}. It configures the Funkwhale instance to be accessible at {{ic|https://funkwhale.local}}.

The folder names should be change to fit your installation. More explanation on which lines need to be modified is provided in [https://docs.funkwhale.audio/installation/index.html#reverse-proxy-setup].

Copy the template to the apache configuration folder,

$ cp /etc/webapps/funkwhale/apache-funkwhale.conf /etc/httpd/conf/extra/funkwhale.conf

Next, edit the [[Apache HTTP Server]] configuration file and add the following:

{{hc|# /etc/httpd/conf/httpd.conf|
Include conf/extra/funkwhale.conf
}}

For the changes to be applied, you need to restart {{ic|httpd.service}} (Apache) using [[systemd#Using units|systemd]].

=== Configure PostgreSQL ===

Here we follow the official documentation: [https://docs.funkwhale.audio/installation/external_dependencies.html]

Connect to the [[PostgreSQL]] command line using the {{ic|postgres}} user to create the {{ic|funkwhale}} user and the database.

{{hc|$ sudo -u postgres psql|2=
CREATE DATABASE "funkwhale"
WITH ENCODING 'utf8';
CREATE USER funkwhale;
GRANT ALL PRIVILEGES ON DATABASE funkwhale TO funkwhale;
\c funkwhale;
CREATE EXTENSION "unaccent";
CREATE EXTENSION "citext";
}}

The last three lines load the {{ic|unaccent}} and {{ic|citext}} extensions,
which are needed for funkwhale to work ({{ic|citext}} since version 0.20).

== Initialization ==

=== Funkwhale user ===

Funkwhale should be run as the {{ic|funkwhale}} user. It is automatically created by the AUR package.
If you followed the manual installation, create it with

$ useradd -r -d /srv/funkwhale -m funkwhale -c "Funkwhale music server -s /sbin/nologin"

Create Funkwhale's data folders in {{ic|/srv/funkwhale}},
owned by the {{ic|funkwhale}} user:

$ mkdir /srv/funkwhale
$ chown funkwhale:funkwhale /srv/funkwhale

Run the following commands as the {{ic|funkwhale}} user.

Create sub-folders for api files and storage.

{{hc|$ sudo -u funkwhale -H bash|2=
[funkwhale]$ cd /srv/funkwhale
[funkwhale]$ mkdir -p api data/static data/media data/music config
}}

To work, Funkwhale needs several environment variables to be present, these should be defined in the environment file {{ic|/srv/funkwhale/config/env}}.
There is a template at {{ic|/etc/webapps/funkwhale/env.template}}, copy and modify it to fit your installation.

[funkwhale]$ cp /etc/webapps/funkwhale/env.template /srv/funkwhale/config/env

The {{ic|FUNKWHALE_HOSTNAME}} variable should correspond to the hostname in {{ic|/etc/hosts}}.
{{ic|DJANGO_ALLOWED_HOSTS}} needs also to match the address where the funkwhale instance will be reached.
You should generate a unique {{ic|DJANGO_SECRET_KEY}} and change the paths accordingly to your installation.

{{Tip|As you will need to run several commands as the {{ic|funkwhale}} user with the environment variables loaded, you can use the following command-line after logging in:

{{ic|[funkwhale]$ export $(cat /srv/funkwhale/config/env {{!}} grep -v ^# {{!}} xargs)}}

For convenience, you can copy this line to /srv/funkwhale/.bashrc (or whichever shell you are using),
so it is loaded automatically everytime you log in to the funkwhale user.
}}

=== Database setup ===

Initialize the database before launching the application:

{{hc|$ sudo -u funkwhale -H bash|2=
[funkwhale]$ python /usr/share/webapps/funkwhale/api/manage.py migrate
}}

Create a superuser for your Funkwhale instance:

[funkwhale]$ python /usr/share/webapps/funkwhale/api/manage.py createsuperuser

Collect the static files for the webapp:

[funkwhale]$ python /usr/share/webapps/funkwhale/api/manage.py collectstatic

{{note|Starting with version 0.21, an alias is provided for {{ic|/usr/share/webapps/funkwhale/api/manage.py}} in {{ic|/usr/bin/funkwhale_manage}}, so you can instead use:
[funkwhale]$ funkwhale_manage collectstatic
}}

== Version upgrade ==

{{note|Starting with version 0.21, an alias is provided for {{ic|/usr/share/webapps/funkwhale/api/manage.py}} in {{ic|/usr/bin/funkwhale_manage}}, so you can use:

[funkwhale]$ funkwhale_manage [commands...]

instead of

[funkwhale]$ python /usr/share/webapps/funkwhale/api/manage.py [commands...]

}}

All commands should be entered as {{ic|funkwhale}} [[#Funkwhale user|user]].
[[Stop]] the {{ic|funkwhale.service}} before upgrading.

The static files have to be collected again:

[funkwhale]$ funkwhale_manage collectstatic --no-input

Apply database migrations:

[funkwhale]$ funkwhale_manage migrate

To upgrade to version 1.0, the thumbnails quality has been increased from 70 to 95, so all the thumbnails should be regenerated (or set THUMBNAIL_JPEG_RESIZE_QUALITY=70 in the .env file so nothing changes).
First delete the {{ic|__sized__ directory}} in your {{ic|MEDIA_ROOT}} directory, then regenerate the thumbnails,

[funkwhale]$ rm -rf /srv/funkwhale/data/media/__sized__
[funkwhale]$ funkwhale_manage fw media generate-thumbnails

Starting from version 0.20.1, there is a new {{ic|MUSIC_USE_DENORMALIZATION}} parameter in the {{ic|env}} file set to {{ic|True}} (you can set it to {{ic|False}} so nothing changes). It is a performance enhancement and to make it work you need to run the following command,

[funkwhale]$ python /usr/share/webapps/funkwhale/api/manage.py rebuild_music_permissions

{{warning|Check that the apache or nginx configuration file did not change before restarting the service. Consult the official documentation for incompatible changes.}}

{{warning|From version 0.20, {{AUR|python-daphne}} was replaced by {{Pkg|uvicorn}}/{{Pkg|gunicorn}}. The service file was updated not to use {{AUR|python-daphne}} anymore. This can be changed by editing the {{ic|funkwhale-server.service}} file.
Also, the {{ic|citext}} extension for postgresql is now needed. It can be loaded with issueing the following command before calling the {{ic|migrate}} command:

{{bc|$ sudo -u postgres psql funkwhale -c 'CREATE EXTENSION "citext";'}}

}}

After completing all these steps, the {{ic|funkwhale.service}} can be [[started]] again.

{{Note|All the instructions for upgrading are given on the official documentation [https://docs.funkwhale.audio/upgrading/index.html].}}

== Usage ==

Upstream provides systemd services that are already installed with the AUR package.

To start the instance, just [[start]] {{ic|funkwhale.service}}.

This starts three services, you can check their status with:

$ systemctl status funkwhale-\*

== Troubleshooting ==

See https://docs.funkwhale.audio/admin/troubleshooting.html

=== Proxy logs ===

Apache logs for funkwhale:

$ tail -f /var/log/httpd/funkwhale/error.log