123 lines
5.4 KiB
Markdown
123 lines
5.4 KiB
Markdown
# live-rec
|
|
|
|
치지직·유튜브 방송을 **미리 대기 걸어 두면 켜지는 순간 녹화**하는 Docker 컨테이너.
|
|
yt-dlp + ffmpeg 기반이고, 웹 화면과 CLI를 함께 제공한다.
|
|
|
|
- 치지직 채널: 30초마다 방송 확인 → 켜지면 녹화
|
|
- 유튜브 채널: 2분마다 확인, 예약 방송은 시작까지 대기
|
|
- 다시보기·클립·일반 영상 주소는 바로 받기
|
|
- **예약**: 정한 시각(기본 한국시간)부터 N시간 동안 방송을 기다린다
|
|
- 녹화가 끊겨도 방송이 계속되면 다시 연결해 이어 녹화 (파일이 나뉨)
|
|
- 웹 화면: 등록·예약·화질 선택, 녹화 용량·속도·경과, 정체 경고, 로그, 중지, 쿠키 입력
|
|
- 여유 공간이 부족하면 지금까지 분량을 저장하고 멈춤
|
|
- yt-dlp는 컨테이너 시작 시와 매일 05시(녹화가 없을 때) 자동 업데이트
|
|
|
|
> 개인 시청 목적으로만 사용하세요. 저작권과 각 플랫폼 이용약관을 지키는 것은 사용자 책임입니다.
|
|
|
|
## 설치
|
|
|
|
Docker Compose가 필요하다 (Synology는 Container Manager).
|
|
|
|
```bash
|
|
git clone <이 저장소 주소> live-rec
|
|
cd live-rec
|
|
cp .env.example .env # 저장 위치(REC_DIR), PUID/PGID 등 수정
|
|
mkdir -p data recordings # REC_DIR을 바꿨다면 그 폴더를 만든다
|
|
docker compose up -d --build
|
|
```
|
|
|
|
웹 화면: `http://<서버 IP>:8790`
|
|
|
|
- **PUID/PGID**: 녹화 파일 소유자. 호스트에서 `id`로 확인해 `.env`에 넣는다.
|
|
이 값은 이미지 빌드에 쓰이므로 바꾸면 `docker compose up -d --build`.
|
|
- **폴더 권한**: `data/`와 저장 폴더는 PUID 사용자가 쓸 수 있어야 한다.
|
|
Docker가 대신 만들면 root 소유가 되니 미리 만들어 둔다.
|
|
- **Synology**: 공유 폴더의 ACL이 상속되면 컨테이너 안에서 읽기 전용으로 보인다.
|
|
그럴 때는 해당 폴더만 ACL을 지우고 일반 권한으로 바꾼다.
|
|
```bash
|
|
sudo synoacltool -del /volume1/<공유폴더>/live && sudo chmod 755 /volume1/<공유폴더>/live
|
|
```
|
|
|
|
## 사용법
|
|
|
|
### 웹 화면
|
|
|
|
주소를 넣고 **확인**을 누르면 방송 중인지 미리 볼 수 있다. 시작을 **지금부터** 또는 **예약**으로 고르고, 기다릴 시간과 화질을 정해 등록한다.
|
|
|
|
### CLI
|
|
|
|
```bash
|
|
R="docker exec live-rec rec"
|
|
$R add https://chzzk.naver.com/<채널ID> -H 6 -m "메모" # 지금부터 6시간 대기
|
|
$R add https://www.youtube.com/@핸들 -a "21:00" -H 3 # 21시부터 3시간 대기 (지난 시각이면 내일)
|
|
$R add <URL> -a "10-05 20:30" -q 1080 # 날짜 지정, 1080p 이하
|
|
$R ls # 목록
|
|
$R st <ID> # 상세 + 로그
|
|
$R stop <ID> # 대기 취소 / 녹화 중지 (분량 저장)
|
|
$R rm <ID> # 끝난 작업 기록 삭제 (녹화 파일은 그대로)
|
|
$R check <URL> # 등록 없이 방송 여부 확인
|
|
$R update # yt-dlp 수동 업데이트
|
|
```
|
|
|
|
ID는 앞부분만 써도 된다. 저장 파일: `<REC_DIR>/<채널명>/<시작시각> <제목> [<id>].mp4`
|
|
|
|
### 쿠키 (성인 방송·연령 제한 영상)
|
|
|
|
치지직 성인 방송은 네이버 로그인 쿠키(`NID_AUT`, `NID_SES`)가 있어야 받을 수 있다.
|
|
웹 화면 아래 **쿠키**에 붙여넣거나, 터미널에서 입력한다 (입력 내용은 화면에 보이지 않음).
|
|
|
|
```bash
|
|
docker exec -it live-rec rec cookies set chzzk # NID_AUT=...; NID_SES=... 한 줄
|
|
docker exec -it live-rec rec cookies set youtube # 유튜브는 Netscape cookies.txt 내용
|
|
docker exec live-rec rec cookies # 상태 확인 (값은 출력하지 않음)
|
|
```
|
|
|
|
쿠키는 계정 로그인 정보다. `data/cookies/`는 다른 사람과 공유하지 말 것.
|
|
브라우저에서 로그아웃하면 쿠키도 무효가 되니 다시 넣어야 한다.
|
|
|
|
## 외부 공개 (선택)
|
|
|
|
웹 화면을 인터넷에 열 때는 리버스 프록시(Caddy, Nginx 등)로 HTTPS를 붙이고 **OIDC 로그인**을 켠다.
|
|
로그인 설정 전에는 프록시를 거친 요청(`X-Forwarded-For` 있음)을 모두 거부하고, 같은 네트워크에서 포트로 직접 들어온 접속만 허용한다.
|
|
|
|
1. OIDC 제공자(Gitea, Authentik, Keycloak 등)에 OAuth2 앱을 만든다.
|
|
- 리디렉션 URI: `https://<공개 주소>/auth/callback`
|
|
- 기밀(confidential) 클라이언트
|
|
2. `.env`에 `REC_OIDC_ISSUER`, `REC_OIDC_CLIENT_ID`, `REC_PUBLIC_URL`, `REC_ALLOWED_USERS`를 채우고 `docker compose up -d`
|
|
3. 클라이언트 시크릿을 넣는다: `docker exec -it live-rec rec auth secret`
|
|
4. 상태 확인: `docker exec live-rec rec auth`
|
|
|
|
허용 계정은 OIDC `preferred_username`으로 확인한다. 세션은 30일 유지된다.
|
|
|
|
Caddy 예시:
|
|
|
|
```
|
|
rec.example.com {
|
|
reverse_proxy 127.0.0.1:8790
|
|
}
|
|
```
|
|
|
|
## 구조
|
|
|
|
| 파일 | 내용 |
|
|
|---|---|
|
|
| `rec.py` | 데몬(작업마다 스레드, yt-dlp 실행·감시)과 CLI |
|
|
| `web.py` | 웹 서버 (표준 라이브러리), OIDC 로그인 |
|
|
| `index.html` | 웹 화면 |
|
|
|
|
상태는 `data/` 아래 파일로만 주고받는다.
|
|
|
|
| 경로 | 내용 |
|
|
|---|---|
|
|
| `jobs/<ID>/job.json` | 요청 |
|
|
| `jobs/<ID>/state.json` | 상태 (데몬만 씀) |
|
|
| `jobs/<ID>/log.txt` | 데몬 이벤트와 yt-dlp 출력 |
|
|
| `cookies/` | 쿠키 |
|
|
| `auth/` | 세션 키, OIDC 시크릿 |
|
|
|
|
녹화 중 파일은 `<REC_DIR>/.rec-tmp/<ID>/`에 있다가 끝나면 이동한다.
|
|
|
|
참고:
|
|
- 유튜브용 JS 런타임 deno를 포함한다.
|
|
- 치지직 라이브의 fMP4 조각(`.m4s`) 때문에 ffmpeg에 `-extension_picky 0`을 넘긴다.
|