Question 1

Docker Compose で UPLOAD_SIZE_LIMIT を設定した後も、なぜ asciinema のアップロードは 500 MB のサイズ制限で失敗し続けるのですか？

Accepted Answer

これは asciinema server バージョン 20250915 のバグで、設定された UPLOAD_SIZE_LIMIT が正しく適用されていませんでした。修正済みリリース v20250923 以降にアップグレードしてください:

services:
  asciinema:
    image: ghcr.io/asciinema/asciinema-server:20250923
    environment:
      - UPLOAD_SIZE_LIMIT=50000000000

値をバイト単位で引用符なしに設定してから、コンテナを再作成してください:

docker compose pull
docker compose up -d --force-recreate

Compose のリスト構文では UPLOAD_SIZE_LIMIT="50000000000" を使用しないでください。引用符がそのまま渡され、Erlang の binary_to_integer 起動エラーを引き起こす可能性があるためです。

Question 2

asciinema のターミナル録画を、ローカルでの再生や YouTube へのアップロード用に MP4 に変換するにはどうすればよいですか？

Accepted Answer

Asciinema にはネイティブの MP4 エクスポート機能がありません（高負荷な動画コーデックを意図的に避けており、近い将来この機能を追加する予定もありません）。以下の回避策のいずれかを使用してください：

1. GIF を経由した 2 段階変換：
   a. オープンソースの [asciinema2gif](https://github.com/tav/asciinema2gif) ツールを使用して、`.cast` 録画ファイルをアニメーション GIF に変換します。
   b. オンラインツール [gif-2-mp4.com](http://gif-2-mp4.com/) を使うか、コマンドラインで GIF を MP4 に変換します（ffmpeg ベースの変換コマンドについては、[こちらの Unix StackExchange ガイド](http://unix.stackexchange.com/questions/40638/how-to-do-i-convert-an-animated-gif-to-an-mp4-or-mv4-on-the-command-line) を参照してください）。

2. 画面録画による方法：
   a. まず、`asciinema play [your-recording-file.cast]` コマンドを実行して、録画をローカルで再生します（プレースホルダーは実際の cast ファイルへのパスに置き換えてください）。
   b. Linux では、Peek スクリーンレコーダーを使用してターミナルの再生出力をキャプチャします。
   c. Windows または macOS では、[LiceCap](https://www.cockos.com/licecap/) を使用して再生ウィンドウを録画して GIF をエクスポートし、必要に応じて GIF を MP4 に変換します。

注意： Asciicast ファイルは編集可能な JSON 形式を使用しているため、変換前に内容を修正または削除できます。ターミナル再生の埋め込みをサポートしているプラットフォームでは、動画に変換する代わりに asciinema ネイティブの埋め込み機能を使用できます。

Question 3

Nginx Proxy Manager の背後で asciinema のセルフホスト ライブストリームがオフラインと表示されるのをどう修正すればよいですか？

Accepted Answer

WebSocketプロキシを有効にし、asciinemaサーバーに外部URLがHTTPSを使用していることを伝えます。通常のアップロードは通常のHTTPで動作しますが、ライブストリーミングにはアップグレードされたWebSocket接続が必要です。

1. Nginx Proxy Managerで、Proxy Hostを開き、Websockets Supportを有効にします。
2. SSLタブで、証明書を有効のままにし、任意でForce SSLを有効にします。
3. カスタムNginx設定を使用する場合は、WebSocketアップグレードヘッダーを含めます:

proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto https;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_read_timeout 3600s;

4. NPMがHTTP経由でコンテナに接続する場合でも、パブリックHTTPS URL用にasciinemaコンテナの環境を更新します:

URL_HOST = "asciinema.example.com";
URL_SCHEME = "https";
URL_PORT = "443";

5. コンテナを再作成/再起動します。例:

podman restart asciinema

ブラウザのDevToolsのNetwork → WSタブで、ストリーム接続がwss://を使用し、ステータス101 Switching Protocolsを返すことを確認します。

Question 4

asciinema の録画をタイトルで検索するにはどうすればよいですか？

Accepted Answer

asciinema.org は Exploreページでタイトルのみの録画検索を組み込みでは提供していません。回避策として、録画の主題で Google を検索し、インデックスされた録画に限定します: your-subject site:asciinema.org inurl:/a/。your-subject を、見つけたいタイトルまたはキーワードに置き換えてください。

Question 5

Kubernetesでasciinema-serverのアップロードエラー `(MatchError) no match of right hand side value: {:error, :enoent}` を修正するにはどうすればよいですか?

Accepted Answer

この障害は、アップロードされた cast をローカルディスクにコピーする際に `Asciinema.Recordings.save_file/2` で発生します。通常、PostgreSQL/CNPG が原因ではありません。`:enoent` は、アップロード先のディレクトリまたは一時ファイルのパスが存在しないことを意味します。 1. Pod 内のストレージパスを確認します: ```sh kubectl exec -n deploy/asciinema -- sh -c \ 'id; ls -ld /opt/app/uploads /tmp; touch /opt/app/uploads/.write-test && rm /opt/app/uploads/.write-test' ``` `/opt/app/uploads` が存在しないか書き込みできない場合は、そこに永続ストレージをマウントしてください。 2. Deployment に PVC を追加します: ```yaml spec: template: spec: securityContext: fsGroup: 1000 containers: - name: asciinema env: - name: LOG_LEVEL value: debug volumeMounts: - name: uploads mountPath: /opt/app/uploads volumes: - name: uploads persistentVolumeClaim: claimName: asciinema-uploads ``` OpenShift の任意の UID に対応するには、initContainer を使ってボリュームを準備してください: ```yaml initContainers: - name: init-uploads image: ghcr.io/asciinema/asciinema-server:latest command: ["/bin/sh", "-c", "mkdir -p /opt/app/uploads && chgrp -R 0 /opt/app/uploads && chmod -R g=u /opt/app/uploads"] volumeMounts: - name: uploads mountPath: /opt/app/uploads ``` 3. 再起動して再試行します: ```sh kubectl rollout restart deployment/asciinema -n ``` 複数のレプリカを実行する場合は、`ReadWriteMany` ストレージまたはオブジェクトストレージを使用してください。`LOG_LEVEL=debug` を設定すると、より詳細なリクエストログが得られますが、欠落しているアップロードディレクトリの修正に代わるものではありません。

asciinema-server

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト