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 upgrade headers를 포함하십시오:

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

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트