Important

ROKFOSS Pastebox는 kmw0410/pastebox를 기반으로 수정/운영되는 포크 버전이며, 원본 레포지토리에 대한 이슈 및 PR은 처리되지 않습니다.

ROKFOSS Pastebox

curl 기반 텍스트/로그 공유 서비스

ROKFOSS Pastebox 관련 문의는 ROKFOSS 공식 디스코드 또는 github@krfoss.org 으로 문의하여 주시길 바랍니다.

서비스 주소

https://paste.krfoss.org

서비스 공지는 ROKFOSS 공식 디스코드를 방문하여 확인하실 수 있습니다

기술 스택

레이어	스택
OS	Alpine Linux 3.23.4 (미러: https://mirror5.krfoss.org/alpine)
언어	Go
프론트엔드	Go HTML Template
백엔드	Go Standard Library HTTP Server
저장소	Local File Storage / MariaDB (선택 가능)
압축 기술	zstd / gzip (DB 모드 시 사용 가능)

어떻게 사용하나요?

1. 저장소를 클론하거나 .zip 파일로 다운로드하세요.

2. config.example.conf 파일을 복사하여 config.conf 설정 파일을 만듭니다.

   cp config.example.conf config.conf

3. 로컬 파일 저장소 모드로 가볍게 실행할지, 대규모 처리를 위해 MariaDB 모드를 활성화할지 config.conf를 수정하여 선택합니다.

4. 직접 컴파일하여 실행 (Go 환경)

   go build -o pastebox ./cmd/server
   ./pastebox

   또는 Docker (GHCR 사전 빌드 이미지)로 실행 소스 코드를 직접 빌드할 필요 없이 GitHub Packages에 등록된 공식 컨테이너를 즉시 끌어와서 실행할 수 있습니다.

   docker run -d --name pastebox \
     -p 8080:8080 \
     -v $(pwd)/data:/paste-data \
     -v $(pwd)/config.conf:/app/config.conf \
     ghcr.io/krfoss/pastebox:latest

   (Docker Compose를 사용하시려면 docker-compose.yml 파일의 image 부분을 ghcr.io/krfoss/pastebox:latest로 수정 후 docker compose up -d를 입력하세요.)

5. http://localhost:8080을 브라우저에서 접속하거나 curl을 사용하여 텍스트나 로그를 업로드하세요.

어떻게 업데이트하나요?

기존에 설치된 Pastebox를 최신 버전으로 업데이트하려면 아래 방법을 사용하세요.

도커(Docker Compose) 사용자:

docker compose pull
docker compose up -d

직접 컴파일(Go Build) 사용자:

git pull
go build -o pastebox ./cmd/server
# 이후 사용 중인 프로세스(systemd 등) 재시작

---

설정 가이드 (config.conf)

Pastebox는 런타임에 로컬 파일 및 데이터베이스 모드를 전환할 수 있도록 key=value 프로퍼티 형식의 .conf 파일을 지원합니다.

# 저장소 모드 (local: 로컬 파일 저장, db: MariaDB/MySQL 연동)
STORAGE_MODE=local

# 서버 대기 주소
LISTEN_ADDR=:8080

# [Local 모드 전용] 데이터가 물리적으로 저장될 경로
DATA_DIR=./data

# 임시 데이터 자동 만료 기간 (일)
EXPIRE_DAYS=30

# [DB 모드 전용] MariaDB DSN 연결 정보 (자동으로 테이블 생성 및 관리)
DB_DSN=root:password@tcp(127.0.0.1:3306)/pastebox?parseTime=true

# [DB 모드 전용] 데이터 초고압축 알고리즘 (zstd, gzip, none 중 선택)
DB_COMPRESSION_ALGORITHM=zstd

# [선택] 관리자 로그인 마스터 토큰 (비워둘 시 최초 서버 기동 시 256자 임의 토큰을 자동 생성해 채워넣습니다)
ADMIN_TOKEN=

---

기능

1. 데이터 자동삭제: 업로드 시점 기준 30일 후 자동삭제 (백그라운드 정리 고루틴 기동)

2. 텍스트 업로드: **echo, cat (cat << EOF)**와 같이 리눅스 명령어와 연계하여 업로드 가능

   echo "hello" | curl -X POST --data-binary @- http://localhost:8080/

3. 명령어 출력 업로드: 서버 로그나 시스템 현황(ifconfig, df -h 등) 결과를 직접 파이프로 연결하여 다이렉트 업로드 가능

   ifconfig | curl -X POST --data-binary @- http://localhost:8080/

4. 텍스트 파일 업로드: multipart/form-data 대신 대용량 처리에 유리한 바이너리 직접 전송 방식 지원

   curl -v --data-binary @test.txt http://localhost:8080/

   JSON 응답이 필요하면 /json 계열 경로를 사용하세요.

   curl -v --data-binary @test.txt http://localhost:8080/json

5. 비밀번호 보호 링크: usepassword: true 헤더를 사용한 비공개 업로드 링크생성 지원 (헤더 사용시 영문(대+소문자) + 숫자 조합으로 생성된 8자리 비밀번호 발급 및 ?password=... 혹은 paste-password: ... 헤더로 접근 가능)

   # 비밀번호 링크 생성:
   curl -H "usepassword: true" -v --data-binary @secret.txt http://localhost:8080/
   
   # 데이터 확인:
   curl -H "paste-password: RANDOM_PASSWORD" http://localhost:8080/RANDOM_CODE
   
   curl http://localhost:8080/RANDOM_CODE?password=RANDOM_PASSWORD

   비밀번호 직접 지정: /pw/<비밀번호> 경로로 업로드하면 그 문자열이 그대로 비밀번호가 됩니다. (예: /pw/12345 → 비밀번호 12345) /pw/ 바로 뒤 세그먼트는 항상 비밀번호라 temp·week 같은 단어도 비밀번호로 쓸 수 있으며(/pw/week/week → 비밀번호 week), 마지막에 정책 키워드를 덧붙여 조합할 수 있습니다.

   # 비밀번호 12345:
   echo "secret" | curl -X POST --data-binary @- http://localhost:8080/pw/12345
   
   # 비밀번호 12345 + 1회 열람 후 파기 / + 1주 보관:
   echo "secret" | curl -X POST --data-binary @- http://localhost:8080/pw/12345/temp
   echo "secret" | curl -X POST --data-binary @- http://localhost:8080/pw/12345/week
   
   # 헤더로 지정 (URL 로그 노출 방지). 정책 경로와 자유롭게 조합 가능:
   echo "secret" | curl -H "custom-pw: 12345" -X POST --data-binary @- http://localhost:8080/week

   /pw/<비밀번호> 방식은 비밀번호가 URL 경로에 포함되어 프록시·접근 로그에 남습니다. 민감하면 custom-pw 헤더 방식을 권장합니다. /pw/temp·/pw/week처럼 비밀번호 없이 정책 키워드만 오면 비밀번호가 지정되지 않으며, 이때는 custom-pw(또는 usepassword: true) 헤더로만 비밀번호를 붙일 수 있습니다.

6. 1주 보관 후 자동 삭제: /week 경로를 사용하면 업로드 시점 기준 7일 후 자동삭제

   echo "hello" | curl -X POST --data-binary @- http://localhost:8080/week

7. JSON 응답 업로드 경로: 기존 텍스트 응답과 별개로 업로드 결과를 JSON으로 받을 수 있습니다.

   curl -X POST --data-binary @- http://localhost:8080/json
   curl -X POST --data-binary @- http://localhost:8080/week/json
   curl -X POST --data-binary @- http://localhost:8080/pw/json
   curl -X POST --data-binary @- http://localhost:8080/pw/12345/week/json

8. 대규모 압축 인메모리 파이프라인 (DB 모드):

   • 데이터베이스 연동 시, 업로드한 데이터를 Go 백엔드 메모리 단에서 zstd 또는 gzip을 통해 초고압축하여 DB에 축소 보관합니다.
   • 이를 통해 디스크 용량을 최대 90% 이상 절감하며 디스크 I/O와 대역폭 사용을 최소화하여 조회가 급증하는 환경에서도 빠른 응답 속도를 냅니다.

9. 관리 대시보드 (/ra):

   • 관리자가 업로드된 모든 paste 데이터를 웹 브라우저에서 편리하게 관리할 수 있는 /ra 모니터링 콘솔을 제공합니다.
   • ADMIN_TOKEN을 통해 안전하게 인증(쿠키 기반) 후 접근하며, 선택 삭제 및 전체 파기 기능을 지원합니다.
   • 최초 기동 시 ADMIN_TOKEN 설정이 비어있다면 영문 대소문자 및 숫자 조합의 256자 마스터 토큰이 자동으로 생성되어 config.conf에 영구 보존됩니다. (최초 생성 시 서버 표준 출력 로그를 통해 토큰 정보를 확인할 수 있습니다.)

프로젝트 구조

경로	설명
cmd/server/	HTTP 서버, 핸들러, 관리자 API
cmd/server/templates/	go:embed용 내장 HTML 템플릿 (디스크 템플릿 없을 때 폴백)
templates/	Docker 및 로컬 실행 시 사용하는 HTML 템플릿 (cmd/server/templates/와 동기 유지)
internal/	저장소 구현 (로컬 파일 / MariaDB)
config.example.conf	설정 예시
docker-compose.yml, Dockerfile	컨테이너 배포