로맨테크

타이중에서 칭징농장 가는 방법: 버스 시간표·관광 패스·추천 코스 정리

ColorFilter — Sat, 25 Apr 2026 13:04:55 +0900

칭징농장(清境農場)은 해발 1,750~2,000m에 위치한 대만(台灣) 난터우현(南投縣)의 대표적인 산악 휴양지 중 하나다. 유럽풍 숙소와 목초지, 산 능선 전망 덕분에 '대만의 작은 스위스'라고도 불린다. 칭징농장의 푸른 초원 지대인 칭칭초원(青青草原)은 귀여운 양들을 바로 앞에서 볼 수 있고 먹이 주기 체험도 가능해서 아이들은 물론 어른들한테도 즐거운 곳이다. 주말·공휴일에는 양털 깎기 쇼와 승마 공연도 관람할 수 있다(유료).

칭칭초원 via Meet Nantou

타이중(臺中)을 여행하는 한국인들은 근교 여행지로 일월담(日月潭)이나 고미습지(高美湿地)를 주로 간다. 칭징농장은 그에 비하면 덜 알려진 편이지만, 개인적으로 칭징농장이 더 기억에 남았던 것 같다. 타이중 근교 여행을 계획하고 있다면 칭징농장도 고려해 보자.

칭징농장은 타이중에서 버스로 약 2.5시간, 차로 1.5시간 정도 걸린다. 교통이 살짝 복잡해 보여서 투어를 이용하는 경우가 많지만, 투어는 최소 5만 원 이상의 비용이 드는 데다 칭징농장 자체가 풍경을 감상하면서 여유롭게 거니는 곳이라 투어가 딱히 필요하지도 않다. 알고 보면 교통편도 그리 복잡하지 않다. 오늘은 타이중에서 칭징농장 가는 방법과 추천 코스를 소개해 볼까 한다.

난터우 버스 간청역

칭징농장으로 가는 버스는 난터우 버스 간청역(南投客運干城站)에서 탈 수 있다. 일월담, 시터우(溪頭) 가는 버스도 이곳에서 탑승하기 때문에 꽤나 유명한 버스 정류장이다. 외국 여행객들이 많이 찾아와서 그런지 직원분들이 영어 소통도 어느 정도 가능한 편이다. 타이중 버스는 시간 변동이 잦으므로 시간을 미리 확인하고 여유 있게 도착하는 것이 좋다. 도착하면 직원에게 목적지를 말하고 번호표(플라스틱으로 코팅된)를 미리 받아두자(번호표 순서대로 탑승).

난터우 버스 간청 역 전경

칭징 관광 패스

난터우 간청 버스역에서 칭칭초원 입장권과 왕복 버스표 등이 포함된 관광 패스(清境好行套票)를 판매한다. 이 패스를 이용하면 스카이워크, 스위스가든 등에서 할인 혜택도 받을 수 있다. 가격은 630 TWD(약 29,000원). 간청역에서 칭징까지 편도 요금은 이지카드 기준 200 TWD 정도이고 칭칭초원 입장권은 성인 270 TWD인 점을 감안하면 꽤나 실속 있다. 이 패스 하나로 칭징농장 여행에 필요한 교통편과 입장권을 해결할 수 있고 가성비도 좋은 편이어서 패스권 구매를 추천한다.

[패스 포함 내역]

칭칭초원 입장권
타이중 <> 칭징 왕복 버스
국민빈관(國民賓館, 칭징 게스트하우스) <> 칭칭초원 왕복 버스
국민빈관 할인 (평일 30%, 주말 10%)
스위스가든(小瑞士花園) 할인
스카이워크(清境高空觀景步道) 할인 (30 TWD)
칭칭초원·국민빈관 내 농산품, 기념품, 매장 할인

칭징농장은 중간 정거장인 푸리(埔里)를 경유하기 때문에 교통 티켓은 편도마다 2장씩(타이중 <> 푸리, 푸리 <> 칭징) 제공한다. 직행 버스를 탑승한다면 승차 시 2장을 모두 수거해 간다. 패스의 QR 코드를 스캔하면(링크) 할인 매장 목록(중국어)을 볼 수 있다.

2026 칭징 관광 패스

버스 시간표

가는 편 (타이중 > 칭징)

제대로 설명한 블로그가 없어서 가장 헷갈렸던 부분이다. 칭징농장으로 가는 칭징선(清境線) 버스는 푸리(埔里)라는 중간 정거장에 잠시 정차하고, 여기서 한 번 갈아타야 된다. 하지만 간청역 기준 08:30, 09:15, 09:55, 11:15에 출발하는 6664번 버스는 환승 없이 칭징농장까지 직행으로 갈 수 있다.

다만 직행 버스도 푸리역에서 잠시 정차하는데, 이때 이지카드(悠遊卡)로 탑승했다면 한 번 더 태그해야 하니 주의하자(버스 기사님이 안내해 준다). 실제 환승은 하지 않지만 요금 구간이 나뉘는 방식이라고 보면 된다. 패스권으로 탑승한 경우 따로 태그하지 않아도 된다. 자세한 버스 시간표는 링크에서 확인할 수 있다.

간청역 > 칭징농장 버스 시간표

오는 편 (칭징 > 타이중)

국민빈관(國民賓館) 정류장에서 09:10, 11:10, 12:10, 13:10, 14:10, 15:10 출발하는 버스를 타면 환승 없이 직행으로 갈 수 있다. ⚠️ 직행 시간대에 탑승했지만 운행 상황에 따라 푸리에서 환승이 필요한 경우도 가끔 발생하니 참고하자.

국민빈관 > 간청역 버스 시간표

국민빈관 버스 정류장 위치

칭징농장 추천 코스

칭칭초원에서 국민빈관으로 이어지는 길은 대체로 내리막길이라 이 방향으로 이동하는 것이 훨씬 수월하다. 칭칭초원 버스 정류장에서 하차해서 초원을 둘러보고 푸드코트 부근에서 점심을 먹은 뒤, 스카이워크를 따라 국민빈관 쪽으로 내려오는 코스가 체력적으로 부담이 덜하다. 대략적인 루트는 구글 지도로 만들어뒀으니 참고하자.

08:30 난터우 버스 간청역에서 직행 버스 탑승
11:00 칭칭초원 버스정류장 하차
칭칭초원 입장(정문) 및 관광
- 칭징 장성 산책로(清境長城步道)
- 관산 역참(觀山驛站)
칭징농장 푸드코트 부근에서 점심 식사 - 아청 식당(阿青的店) 추천
- 염소 고기 볶음밥(山羊炒飯) 150 TWD
- 동과 밀크티(冬瓜鮮奶) 55 TWD
- 멧돼지 고기 소시지 (山豬肉香腸) 45 TWD
칭칭초원 스카이워크 입장 (남문)
칭징 스카이워크
삼나무 숲길(清境柳杉步道) - 길을 따라 내려가다 보면 스위스가든 입구도 지나친다.
국민빈관(國民賓館) - 산양유/밀크티 마시면서 로비에서 휴식
15:10 국민빈관 버스정류장에서 직행 버스 탑승

기타 팁

국민빈관에서 판매하는 산양유 (60 TWD)

칭징농장은 1750m가 넘는 고산지대라 날씨는 선선해도 햇빛은 강렬하다. 얼굴뿐 아니라 목, 팔 등 노출되는 부위 모두 자외선 차단제를 꼼꼼히 발라 주는 게 좋다.
날씨가 절반은 먹고 들어가는 곳이니, 가능하면 맑은 날을 골라 가자. — 대만 중앙기상서(CWA) 홈페이지
산간 지역 특성상 오후에 갑자기 비가 오는 경우도 있다. 작은 우산을 챙겨 두면 좋다.
칭칭초원 입장 시 손등에 꼭 도장을 찍어 두자. 그래야 다른 구역을 둘러본 뒤에도 재입장할 수 있다.
산양유(鮮羊乳), 산양유 밀크티(鮮羊奶茶)는 한 번쯤 마셔 보자. 국민빈관, 칭징 장성 산책로(清境長城步道) 부근 매장에서 판매한다.
일부 매장은 현금 결제만 가능하므로 현금을 챙겨 두는 것이 좋다. 스위스가든 입구 쪽 세븐일레븐에 CTBC ATM 기기가 있다.
코리데일(주력 품종), 바바도 양, 서퍽(검은 얼굴/다리), 발레 블랙노즈(검은 얼굴/나선형 뿔) 등 다양한 품종의 양을 만나볼 수 있다.

참고 이미지

칭칭초원 정문

장성 산책로 부근 밀크티 판매점 (패스권 보여주면 할인 가능)

스카이워크 입구

푸드코트 부근 점심식사 장소

관산 역참 부근

관산 역참 부근에서 볼 수 있는 발레 블랙노즈 품종

홍콩 번호 발급·문자 수신·ICCID 실명 인증 방법 (eSender)

ColorFilter — Fri, 24 Apr 2026 00:46:29 +0900

얼마 전 홍콩 번호로 문자 인증할 일이 생겨서 이런저런 방법을 알아보다가 eSender(易博通)라는 서비스를 이용했는데, 생각보다 만족스럽게 사용했다.

eSender는 홍콩에 본사를 둔 회사로, SIM 카드 없이 중국 본토(+86), 홍콩(+852) 등의 가상 전화번호를 발급해 주는 서비스다. 번호 발급 후엔 앱(App)이나 위챗(Wechat, 微信) 공식 계정(公众号)을 통해 문자를 수신할 수 있다. Blacktel, Zadarma, Telnum 등 비슷한 서비스가 많지만 eSender 가격이 가장 저렴하다.

eSender 앱 메인 화면. 영어를 지원한다.

가격

위챗 공식 계정에서는 문자 수신만 가능하다. 전화도 수신(무료)하려면 eSender 앱이 필요하다. 별도 크레딧을 충전(최소 30 HKD)하면 앱에서 문자·전화 발신도 할 수 있다.

홍콩 번호 발급은 ①사용 이력이 없는 신규 번호(全新号码), ②일반 번호(一般手机号) 두 가지 종류로 나뉜다. 신규 번호는 1년 단위로만 판매하기 때문에 단기 사용이 목적이라면 일반 번호를 선택하는 게 좋다. 일반 번호 기준 가격은 다음과 같다.

30일: 18 HKD (약 3,400원)
90일: 38 HKD (약 7,100원)
360일: 118 HKD (약 22,000원)

구매 팁

홍콩 번호는 eSender 앱과 위챗 공식 계정 두 곳에서 모두 구매할 수 있다. 다만 앱에서 구매한 번호는 앱에서만 문자를 수신할 수 있는 반면, 위챗에서 구매한 번호는 위챗·앱 양쪽에서 문자를 수신할 수 있다(앱에서 위챗 연동 필요). 결제는 애플페이, 페이팔, 카카오페이(원화 결제) 등 다양한 방식을 지원한다.

eSender 공식 한국어 페이지에 위챗을 이용한 구입 방법이 자세히 안내되어 있다. 해당 페이지에서 프로모션 할인 코드도 확인할 수 있으니 놓치지 말자.

2026년 4월 eSender 프로모션 코드

실명 인증

홍콩/마카오는 2022년부터 통신 실명제를 시행하고 있다. 때문에 홍콩 번호를 사용하려면 ICCID(Integrated Circuit Card Identifier) 실명 인증이 필요하다. ICCID는 SIM 카드에 부여된 고유 식별 번호로, 구매한 홍콩 번호를 본인 명의(여권)로 등록하는 절차라고 보면 된다.

실명 인증 안내 문자

먼저 휴대폰으로 https://kyc.multibyte.com 실명 등록 페이지에 접속한다(모바일만 가능). 우측 상단 햄버거 버튼(☰) > 语言 > English를 클릭하면 페이지 언어를 영어로 변경할 수 있다.

Mobile No 탭 > 발급받은 휴대폰 번호(+852 제외 8자리) 입력 > Send 버튼을 눌러서 인증번호를 받는다. 인증번호를 입력하고 Okay 버튼 클릭 > 다음 화면에서 여권 정보(사진 나오는 면) 찍어서 업로드하면 끝. 빠르면 5~10분 안에 실명 인증이 완료된다.

개인은 최대 10개, 기업은 최대 25개의 선불 SIM 카드를 등록할 수 있다.

[CLI] 유용한 셸(Shell) 터미널 단축키/팁 모음

ColorFilter — Fri, 10 Apr 2026 23:35:21 +0900

셸 공통 기능

라인 편집 단축키

Ctrl + W : 커서 앞 단어 잘라내기

# Before
Excepteur sit est non sed excepteur in commodo.|
# After
Excepteur sit est non sed excepteur in |

Ctrl + U : 커서부터 줄 시작까지 잘라내기

# Before
Excepteur sit est non sed excepteur in commodo.|
# After (커서 앞 내용 다 지워짐)
|

Ctrl + K : 커서부터 줄 끝까지 잘라내기

# Before
Excepteur |sit est non sed excepteur in commodo.
# After
Excepteur |

Ctrl + Y : 가장 최근에 잘라낸 내용 붙여넣기

# Before
Excepteur sit est non sed excepteur in |
# After
Excepteur sit est non sed excepteur in commodo.|

Ctrl + A : 줄 맨 앞으로 이동

# Before
Excepteur sit est non sed excepteur in commodo.|
# After
|Excepteur sit est non sed excepteur in commodo.

Ctrl + E : 줄 맨 끝으로 이동

# Before
|Excepteur sit est non sed excepteur in commodo.
# After
Excepteur sit est non sed excepteur in commodo.|

Alt + B : 단어 단위로 뒤로 이동

# Before
Excepteur sit est non sed excepteur in commodo.|
# After
Excepteur sit est non sed excepteur in |commodo.

Alt + F : 단어 단위로 앞으로 이동

# Before
Excepteur |sit est non sed excepteur in commodo.
# After
Excepteur sit |est non sed excepteur in commodo.

터미널 복구

글자가 보이지 않거나, 줄바꿈이 이상해지거나, 화면 표시가 깨졌거나, 어떤 프로그램이 비정상적으로 종료되면서 터미널 상태가 꼬였을 때 유용한 복구 명령어.

# 터미널 상태 초기화
reset
# 터미널 입력 설정 복구
stty sane

긴급 제어

Ctrl + C : 현재 포그라운드에서 실행 중인 명령 중단
Ctrl + D : EOF(End of File; 더 이상 입력할 내용 없음) 전송. cat처럼 입력을 기다리는 프로그램이나 Python 같은 인터프리터를 종료할 때 자주 사용한다.

화면 정리

Ctrl + L : 터미널 화면 정리
macOS 터미널에선 Command + K 단축키로도 가능

디렉터리 이동

cd - : 바로 이전 디렉터리로 이동
pushd [경로] : 현재 디렉터리를 스택에 저장하고 지정한 디렉터리로 이동
popd : 저장해 둔 디렉터리로 복귀 (디렉터리 스택의 맨 위 경로)

파일 비우기

> 파일명 : 파일은 삭제하지 않고 내용만 비움

echo "Hello World" > hello.txt
cat hello.txt
# Hello World

> hello.txt
cat hello.txt
# (내용없음)

이전 명령의 마지막 인자 재사용

$_ : 직전 명령의 마지막 인자 참조 (히스토리에는 값 노출 없이 $_ 으로 기록됨, 스크립트에서도 사용 가능)

mkdir -p project/src
cd $_
pwd
# project/src

셸 스크립트 안전 장치

set -e : 명령 실패 시 스크립트 종료
set -u : 정의되지 않은 변수 사용 시 에러
set -o pipefail : 파이프라인 중간 명령을 실패하면 전체를 실패로 처리

Bash / Zsh 기능

히스토리 검색

Ctrl + R : 이전에 실행한 명령을 히스토리에서 역방향으로 검색

명령 재사용

!! : 직전 명령어 다시 실행

pwd 
# /Users/me/project
!!
# pwd
# /Users/me/project

에디터로 명령 편집

Ctrl + X, Ctrl + E : 현재 입력 중인 명령을 에디터로 열기

# 터미널에 긴 명령어를 입력하다가...
git commit -m "fix: adjust shell shortcut docs and add editor examples"

# Ctrl + X, Ctrl + E 단축키를 누르면
# 입력 중이던 내용이 에디터에서 열림
# 에디터에서 수정한 뒤 저장하고 종료하면
# 수정된 내용이 터미널 입력창에 반영됨

fc : 이전 명령을 $EDITOR에서 편집

# 직전에 실행한 명령
git rebase -i HEAD~5

# 다시 수정해서 실행하고 싶을 때
fc

# 방금 실행한 명령이 에디터에서 열림
# HEAD~10으로 고친 뒤 저장하고 종료하면
# 수정한 명령이 다시 실행됨

이전 명령의 마지막 인자 가져오기

Esc + . 또는 Alt + . : 직전 명령의 마지막 인자를 현재 커서 위치에 삽입

mkdir -p project/src
cd 
# 여기서 Alt + .
# project/src 가 자동으로 입력됨

!$ : 직전 명령의 마지막 인자 참조 (히스토리에는 실제 값으로 치환되어 기록됨, 셸 전용)

mkdir -p project/src
cd !$
pwd
# project/src

중괄호 확장 (Brace Expansion)

{} 안에 값이나 범위를 넣어 여러 문자열을 한 번에 생성할 수 있는 기능. 쉼표(,)는 여러 값을 나열할 때 사용하고, .. 는 연속된 범위를 지정할 때 사용한다.

echo file{1,2,3}.txt
# file1.txt file2.txt file3.txt

mkdir -p project/{src,dist,public}
# project/src project/dist project/public 디렉터리 생성

echo {1..5}
# 1 2 3 4 5

echo {a..d}
# a b c d

프로세스 치환 (Process Substitution)

명령어의 출력을 임시 파일처럼 다룰 수 있는 기능. <(명령어)는 실행 결과를 파일처럼 읽을 수 있게 하고(read), >(명령어)는 출력을 파일에 쓰듯(write) 다른 명령으로 보낼 수 있게 한다.

# 임시 파일 생성 없이, 두 디렉터리의 파일 목록 차이를 바로 비교
diff <(ls dirA) <(ls dirB)

# 각 명령어의 실행 결과를 텍스트 파일처럼 이어서 출력
cat <(echo "hello") <(echo "world")
# hello
# world

# app.log 내용을 출력하면서 ERROR 줄만 error.log에 저장
tee >(grep "ERROR" > error.log) < app.log
# tee: 입력받은 데이터를 화면(stdout)과 다른 출력 대상으로 동시에 보냄
# 흐름: app.log 읽기 → 화면에 전체 출력 → 동시에 grep으로 넘겨 ERROR만 따로 저장

글로브 패턴 (Glob Pattern)

파일 경로를 패턴으로 매칭하는 기능. *는 현재 디렉터리 수준에서 매칭하고, **는 하위 디렉터리까지 재귀적으로 탐색한다. bash에서 **를 사용하려면 shopt -s globstar 명령어로 globstar 옵션을 활성화해야 한다. zsh에서는 기본적으로 **를 사용할 수 있다.

# 현재 디렉터리의 .js 파일 출력
echo *.js

# 현재 디렉터리와 모든 하위 디렉터리의 .js 파일 출력
echo **/*.js

# 모든 하위 디렉터리의 .md 파일 출력
ls **/*.md

# src의 모든 하위 디렉터리에서 .ts 파일을 찾아 dist로 복사
cp src/**/*.ts dist/

작업 제어 (Job Control)

실행 중인 프로세스를 일시 중지하거나 백그라운드에서 계속 실행하는 기능. Ctrl + Z 단축키로 현재 포그라운드 작업을 일시 중지할 수 있고, bg 명령어로 중지한 작업을 백그라운드에서 재개할 수 있다. 반대로 백그라운드 작업을 다시 포그라운드로 가져올 땐 fg를 사용한다. 현재 셸이 관리 중인 작업 목록은 jobs로 확인할 수 있다.

터미널을 종료해도 작업을 계속 실행하게 만드려면 작업을 백그라운드로 보낸 뒤 disown 명령을 사용하면 된다. disown은 특정 작업을 셸 작업 목록에서 제거해서 셸 종료 시 전송되는 SIGHUP 시그널(연결이 끊겼다고 알리는 신호)을 받지 않도록 만든다.

disown으로 분리한 작업은 jobs에 더 이상 표시되지 않으므로 ps나 pgrep으로 실행 여부를 확인해야 한다.

# 실행 중인 프로세스 일시 중단
node server.js
^Z
# [1]+ Stopped node server.js

# 중단된 작업을 백그라운드에서 계속 실행
bg %1
# [1]+ node server.js &

# 현재 작업 목록 확인
jobs
# [1]+ Running node server.js &

# 셸을 닫아도 프로세스가 종료되지 않도록 작업 목록에서 제거
disown %1

명령어 뒤에 &를 붙이면 처음부터 백그라운드로 실행할 수도 있다.

pnpm start:dev &

출력 모니터링과 로그 저장

|&는 표준 출력(stdout)과 표준 에러 출력(stderr)을 합친 후 다음 명령어로 전달(파이프)하는 문법이다. tee 명령어를 사용하면 출력 내용을 화면에 표시하면서 파일로도 저장할 수 있다.

# stdout과 stderr를 화면에 출력하면서 all.log에 저장
command |& tee all.log

# 기존 로그 파일 끝에 이어서 저장 (-a: append)
command |& tee -a all.log

# 빌드 결과를 화면에 보면서 로그 파일에도 저장
pnpm build |& tee build.log

# 서버 로그를 화면에 출력하면서 기존 파일 끝에 계속 추가
pnpm start:dev |& tee -a server.log

|&는 Bash 4+와 zsh에서 지원하는 단축 문법으로, 2>&1 | 동작과 동일하다. sh 스크립트나 구형 환경에서는 2>&1 |를 사용해야 한다.

# |& 와 동일한 동작
pnpm build 2>&1 | tee build.log

레퍼런스

Shell Tricks That Actually Make Life Easier (And Save Your Sanity)

티스토리 블로그에 자동 목차(TOC) 추가하기

ColorFilter — Tue, 7 Apr 2026 21:00:45 +0900

개인적으로 호흡이 긴 글을 읽을 때는 목차부터 확인하는 편이다. 목차를 보면 글 전체 흐름을 빠르게 파악할 수 있고, 필요한 부분만 골라서 읽을 수 있기 때문이다. 블로그 글도 마찬가지로 내용이 길어질수록 목차가 있으면 글 읽기가 한결 수월해진다.

목차는 영어로 TOC(Table of Contents)라고 부르는데, 노션(Notion) 사용자라면 /toc 명령어로 목차를 손쉽게 삽입해 본 경험이 있을 것이다. 그만큼 익숙하고 유용한 기능이다.

노션의 목차 삽입 명령어

아쉽게도 티스토리(Tistory)는 목차 기능을 제공하지 않는다. 다만 티스토리 본문은 어느 정도 시맨틱 마크업(의미/역할에 맞는 HTML 구조)을 따르고 있어서 기본모드 에디터 기준 제목1~제목3은 <h2>~<h4>, 본문은 <p> 같은 태그로 구성되어 있다. 이런 구조 덕분에 자바스크립트(JavaScript)를 활용한다면 티스토리에도 목차 기능을 추가할 수 있다.

원래는 개인적으로 사용하려고 만들었지만, 스크립트 한 줄만 추가하면 대부분의 티스토리 스킨에 적용할 수 있어서 소개해 보려고 한다. 데스크톱은 노션과 비슷한 레일형 디자인을, 모바일은 버튼을 누르면 팝업이 열리는 방식을 적용했다.

데스크톱 목차

모바일(1280px 미만 화면) 목차

설치 방법

티스토리 관리자 > 스킨 편집 > HTML 편집 화면에서 </body> 태그 바로 위에 아래 스크립트를 삽입한다.

<script defer src="https://cdn.jsdelivr.net/gh/romantech/tistory-plugins@latest/dist/toc/index.min.js"></script>

TOC 플러그인은 기본적으로 h2~h4 제목 태그를 대상으로 목차를 생성한다. 제목이 두 개 미만이라면 목차를 표시하지 않는다. 필요하다면 아래 옵션을 조정해서 원하는 제목 레벨을 직접 지정할 수 있다. ⚠️ 옵션 코드는 스크립트 코드보다 위에 위치해야 한다.

<!-- TOC 플러그인 옵션 -->
<script>
  window.RPPlugins = {
    toc: {
      levels: [2, 3, 4, 5], // 목차에 포함할 제목 레벨 (기본값 2, 3, 4)
      headerOffset: 64, // 화면 상단 부터 제목까지의 여백 (기본값 84)
    },
  };
</script>

<!-- TOC 플러그인 스크립트 -->
<script defer src="https://cdn.jsdelivr.net/gh/romantech/tistory-plugins@latest/dist/toc/index.min.js"></script>

플러그인은 다음과 같은 순서로 본문 영역을 탐색한다. 정말 특이한 스킨이 아니라면 아래 셀렉터만으로 무리 없이 찾을 수 있다.

셀렉터	변형 셀렉터
`.contents-style`	`.contents_style`
`.entry-content`	`.entry_content`
`.area-view`	`.area_view`
`.post-content`	`.post_content`
`.article-view`	`.article_view`
`#article`
`.article-cont`	`.article_cont`

스킨 구조가 달라서 본문을 찾지 못하는 경우 셀렉터를 직접 지정할 수 있다.

<script>
  window.RPPlugins = {
    articleSelectors: [".my-article", "#main-content"],
  };
</script>

<script defer src="https://cdn.jsdelivr.net/gh/romantech/tistory-plugins@latest/dist/toc/index.min.js"></script>

주요 기능

색상 모드 자동 전환

데스크톱 TOC는 현재 적용된 블로그 스킨에 맞춰 라이트/다크 모드가 자동으로 전환된다.

왼쪽 라이트 모드, 오른쪽 다크 모드

데스크톱 (1280px 이상)

넓은 화면에선 우측에 레일형 목차가 표시된다. 본문에 집중할 수 있도록 평소에는 막대만 보이고, 마우스를 올리면 제목이 함께 나타난다. 현재 읽고 있는 섹션의 레일 막대는 밝게 하이라이트되며, 제목 레벨이 낮아질수록(h2 → h4) 막대 길이가 점점 짧아진다.

목차 제목은 기본적으로 한 줄로 표시된다. 긴 제목은 마우스를 올렸을 때 왼쪽 툴팁으로 전체 제목을 보여준다.

TOC에서 제목을 클릭하면, 해당 섹션까지 이어지는 레일 막대와 제목이 순차적으로 강조된다.

목차 상단이나 하단에 걸쳐 일부만 보이는 제목을 클릭하면, 해당 제목이 잘 보이도록 자동으로 스크롤된다. 제목 수가 많아 목차 패널에 스크롤이 생긴 상황에서 은근히 유용하다.

모바일 (1280px 미만)

아래로 스크롤해서 본문 영역을 벗어나면 목차가 자동으로 사라진다.

1280px 미만의 좁은 화면에선 레일형 대신 팝업형 목차를 표시한다. 우측 하단 버튼을 누르면 목차 팝업이 나타나고, 제목을 클릭하면 해당 위치로 스크롤되면서 팝업이 자동으로 닫힌다. 모바일 목차는 제목 레벨에 따라 들여쓰기가 적용되어 있어 계층 구조를 쉽게 파악할 수 있다.

TOC 버튼은 본문 영역 안에서 위아래로 드래그할 수 있다. 버튼 위쪽에 공간이 부족하면 목차 팝업은 아래 방향으로 열린다.

기타 플러그인

앵커 링크 외에도 인라인 코드, LaTeX(KaTeX) 렌더링 등 스크립트 한 줄만 추가하면 바로 적용할 수 있는 다른 플러그인도 함께 만들었다. 전체 코드와 더 자세한 설명은 GitHub 저장소에서 확인할 수 있다.

플러그인	설명
inline-code	벡틱(`)으로 감싼 인라인 텍스트를 `<code>`로 변환
katex	텍스트 내 수학 수식을 KaTeX로 렌더링
copy-code	코드 블록 우측 상단에 복사 버튼 추가
focus-guard	사이드바 토글 과정에서 발생하는 `aria-hidden` 포커스 경고 완화
heading-anchor	본문 제목에 앵커 링크를 추가하고 해시 이동 위치 보정

티스토리 블로그 본문에 앵커(Anchor) 링크 추가하기

ColorFilter — Sat, 28 Mar 2026 21:28:34 +0900

앵커 링크(Anchor Link)는 페이지 안에서 특정 위치로 바로 이동할 수 있게 해주는 기능이다. MDN, GitHub, 기술 블로그 등 문서 중심의 웹사이트는 제목 태그(heading)에 앵커 링크를 적용하여 사용자가 원하는 섹션을 빠르게 탐색할 수 있도록 지원한다.

앵커 링크를 클릭해서 특정 섹션으로 이동할 때마다 주소창 URL도 https://...#섹션으로 변경된다. #섹션은 해시(hash)라고 부르는데, 해시가 포함된 주소로 접속하면 브라우저가 해당 위치까지 자동으로 스크롤해 주는 편리한 기능이다.

아쉽게도 티스토리는 자체적인 앵커 링크를 제공하지 않기 때문에 자바스크립트로 직접 구현해야 한다. 아래에서 소개할 앵커 링크 추가 스크립트는 개인적으로 사용하려고 만들었지만, jsDelivr 같은 CDN으로 배포하면 다른 스킨 사용자도 쉽게 활용할 수 있지 않을까 싶어서 플러그인 형태로 정리해 봤다.

적용 방법

티스토리 스킨 편집 > HTML 편집 화면에서 </body> 태그 바로 위에 아래 코드를 삽입한다.

<!-- Heading-anchor -->
<script defer src="https://cdn.jsdelivr.net/gh/romantech/tistory-plugins@latest/dist/heading-anchor/index.min.js"></script>

이 스크립트는 기본적으로 H2~H4 제목 태그를 대상으로 앵커 링크를 생성한다. H1 태그는 포스팅 상단 제목에 사용하므로 제외했다. 본문 제목에 마우스 커서를 올리면 우측에 # 기호가 나타나고, 제목 혹은 # 기호를 클릭하면 해당 위치로 부드럽게 스크롤된다. 전반적인 구조와 동작 방식은 MDN 앵커 링크와 유사하다.

작동 방식

작동 방식은 크게 보면 그리 복잡하지 않다. 먼저 본문에 포함된 모든 제목을 찾은 뒤 고유한 해시를 생성한다. 생성된 앵커 링크(제목)를 클릭하거나 해시가 포함된 주소로 접속했을 땐 해당 위치로 자연스럽게 이동하도록 처리한다(scroll-behavior: smooth 적용).

본문 영역에서 H2~H4 제목 태그를 탐색한다.
제목 텍스트를 기준으로 id를 생성하고, 중복 제목은 번호를 붙여 해시가 겹치지 않도록 한다.
제목 전체를 앵커 링크로 감싸고, 마우스를 올렸을 때 표시할 # 마커를 추가한다.
제목을 클릭하면 URL에 #섹션 해시를 반영하고, 해당 위치로 부드럽게 스크롤한다.
해시가 포함된 주소로 처음 접속했을 때도 같은 방식으로 동작한다.

제목 텍스트 전체 영역에 링크를 적용했다면 앵커 링크가 생성되지 않는다.

설정 옵션

스킨마다 헤더 높이와 본문 구조가 조금씩 다를 수 있으므로, 아래 옵션을 통해 동작 범위를 조정할 수 있다.

headingAnchor.levels

설명: 앵커 링크를 적용할 제목 태그 범위.
기본값: [2, 3, 4] (H2~H4)

headingAnchor.headerOffset

설명: 스크롤 위치 보정값.
상단 고정 헤더가 본문 제목을 가리지 않도록 여백을 추가할 수 있다.
기본값: 84 (화면 상단부터 제목까지의 여백)

articleSelectors

설명: 본문 영역 셀렉터 지정.
플러그인이 본문 영역을 찾지 못할 경우 직접 지정할 수 있다.
기본값: ["#article", ".article-view", ".post-content", ...]

headerOffset은 실제 헤더 높이와 똑같이 맞추기보다, 상단 여백을 고려해 더 크게 설정하는 게 좋다. 예를 들어 헤더 높이가 64px이라면 16px 정도 여유를 더해 80 정도로 설정한 뒤, 스킨에 맞게 조금씩 조정하는 방식을 추천한다.

<script>
window.RPPlugins = {
  articleSelectors: [".my-custom-article"], // 본문 영역 셀렉터 직접 지정
  headingAnchor: {
    levels: [2, 3, 4, 5], // H2~H5 제목에 적용
    headerOffset: 80 // 헤더 높이 64px + 여유값 16px
  }
};
</script>

<script defer src="https://cdn.jsdelivr.net/gh/romantech/tistory-plugins@latest/dist/heading-anchor/index.min.js"></script>

⚠️ 설정 옵션 코드는 플러그인 스크립트보다 상단에 위치해야 정상적으로 적용된다.

기타 플러그인

플러그인	설명
inline-code	벡틱(`)으로 감싼 인라인 텍스트를 `<code>`로 변환
katex	텍스트 내 수학 수식을 KaTeX로 렌더링
copy-code	코드 블록 우측 상단에 복사 버튼 추가
focus-guard	사이드바 토글 과정에서 발생하는 `aria-hidden` 포커스 경고 완화
toc	자동 목차(TOC) 추가

[크롬 확장] 워터마크 제거·모델 고정 등 Gemini 더 편하게 쓰기 - Voyager

ColorFilter — Sat, 7 Mar 2026 21:57:29 +0900

요즘은 ChatGPT 만큼 구글 제미나이(Gemini)를 메인으로 활용하는 사람들이 많아진 것 같다. 얼마 전 제미나이 웹 버전의 아쉬운 부분을 보완해 주는 Gemini Voyager 라는 크롬 확장 프로그램을 설치해서 쓰고 있는데, 제미나이 사용 만족도가 크게 올라갔다.

특히 나노바나나(NanoBanana) 워터마크 제거 기능이 정말 유용하다. 이 밖에도 대화 타임라인, 폴더 관리, 프롬프트 라이브러리 같은 다양한 편의 기능을 제공한다. 사용하다 보면 이게 원래 기능인지, 확장 프로그램 기능인지 헷갈릴 정도로 제미나이 기본 UI와 자연스럽게 통합해 놨다. 제미나이 유저라면 강력 추천하는 부가기능이다.

다운로드

크롬 스토어

공식 홈페이지

주요 기능

타임라인

우측 타임라인 막대를 이용해 이전 대화로 이동할 수 있는 기능. 질문/답변이 생성될 때마다 원 모양의 노드가 추가되며, 클릭하면 해당 대화 위치로 스크롤된다. j, k 키보드 단축키로 노드 간 이동도 가능하다. 스크롤바에 마우스 커서를 올리면 왼편에 작은 아이콘이 나타나는데, 클릭하면 전체 질문 목록(TOC) 팝업이 열린다. 여기서 질문을 검색하거나 클릭해서 바로 이동할 수 있다.

Voyager 설정 > 외부 컨테이너 숨기기에 체크하면 스크롤 막대의 배경색을 투명으로 바꿀 수 있다.

노드를 길게 클릭하면 노란색 북마크로 표시할 수 있다.

나노바나나 워터마크 제거

개인적으로 가장 마음에 드는 기능이다. Voyager 설정 > NanoBanana 워터마크 제거 옵션에 체크하면, 나노바나나로 생성된 이미지를 다운로드할 때 워터마크를 자동으로 제거해 준다. 워터마크를 제외한 나머지 영역은 원본과 동일하게 유지된다.

사이드바 자동 숨기기

마우스 커서를 제미나이 창 왼쪽 가장자리로 가져가면 사이드바가 나타나고, 영역을 벗어나면 자동으로 접히는 기능. 덕분에 왼쪽 상단 사이드바 아이콘을 매번 클릭할 필요가 없어진다. Voyager 설정 > 사이드바 자동 숨김 옵션에 체크하면 활성화된다.

기본 모델 고정

제미나이는 새 대화를 시작할 때 기본적으로 '빠른 모델'이 선택된다. Voyager를 통해 특정 모델을 기본값으로 설정할 수 있다. 모델 선택 팝업 > 별표 아이콘을 클릭해서 원하는 모델로 고정해 보자.

입력창 접기

입력창에 아무것도 입력하지 않은 상태에서 바깥 영역을 클릭하는 순간(포커스 해제), 입력창을 자동으로 숨겨주는 기능. 덕분에 화면을 더 넓게 활용할 수 있다. 숨겨진 입력창은 다시 클릭하거나 Cmd(Ctrl) + I 단축키로 표시할 수 있다. Voyager 설정 > 입력창 접기 활성화 옵션에 체크하면 이 기능을 사용할 수 있다.

자동 스크롤 방지

Gemini가 답변을 작성 중일 땐 화면 가장 아래로 강제 스크롤된다. 이 기능을 켜면 강제 스크롤을 방지해서 답변 생성 도중에도 이전 대화 내용을 훑어볼 수 있다. 은근히 유용한 꿀 기능이다 . Voyager 설정 > 자동 스크롤 방지 옵션에 체크하면 활성화된다.

대화 내보내기

왼쪽 상단 Gemini 로고 > 내보내기 버튼을 클릭하면 원하는 포맷으로 대화 내용을 저장할 수 있다. 마크다운(Markdown)으로 저장하면 노션(Notion)이나 옵시디언(Obsidian)에 그대로 붙여넣을 수 있다.

프롬프트 라이브러리

자주 사용하는 프롬프트를 저장해 두고 필요 시 빠르게 불러올 수 있는 기능. 각 프롬프트에 1개 이상의 태그를 지정할 수 있다. 프롬프트 목록은 초록색 플로팅 아이콘을 클릭하면 표시되고, 아이콘을 드래그해서 원하는 위치로 이동할 수도 있다. 프롬프트 라이브러리 기능이 필요 없다면 Voyager 설정 > 프롬프트 관리자 숨기기 옵션에 체크해서 플로팅 아이콘을 감출 수 있다.

폴더 기능

대화를 폴더별로 정리해 둘 수 있는 기능. 계층 구조를 지원하므로 하위 폴더를 생성할 수 있다. 각 폴더는 고정하거나 즐겨찾기로 표시할 수 있고, 색상도 변경할 수 있다. 필요하면 Google Drive 업로드를 통해 폴더 구조와 프롬프트를 동기화할 수도 있다. 드래그 앤 드롭으로 특정 대화를 폴더에 추가할 수 있고, 대화를 길게 눌러 여러 개를 선택한 뒤 한 번에 옮기는 것도 가능하다. 폴더 기능을 사용하지 않는다면 Voyager 설정에서 비활성화할 수 있다.

위에서 소개한 것 외에도 사이드바·대화 너비 조정, 인용 답장, 대화 일괄 삭제, 최근 항목·Gem 숨기기, 탭 제목 동기화 등 다양한 편의 기능을 제공하니 취향에 맞게 직접 설정해 보자. 오픈소스(GPLv3) 프로젝트인 만큼 기능 개선/추가 속도도 매우 빠른 편이다.

공식 가이드 문서는 한글로도 제공된다. 특정 기능 사용법을 잘 모르겠으면 공식 문서를 확인해 보자.

AI가 사람을 호출하기 시작했다

ColorFilter — Thu, 5 Mar 2026 02:00:11 +0900

David Paul Morris ❘ Bloomberg ❘ Getty Images

최근 미국에선 자율주행 관련 뉴스 하나가 화제다. 대표적인 자율주행 기업 웨이모(Waymo)는 이미 미국 여러 도시에서 로보택시(무인 택시) 서비스를 운영 중이다.

그런데 이 서비스에 뜻밖의 골칫거리가 있었다. 승객이 내린 뒤 차문이나 트렁크를 제대로 닫지 않아 차량이 다음 목적지로 출발하지 못하는 일이 종종 벌어졌던 것.

최첨단 기술 회사인 만큼 '원격 문 제어 기능'으로 해결할 법도 하지만, 웨이모가 택한 방법은 의외로 '사람 호출'이었다. 배달 플랫폼에 주문을 넣어 배달원을 현장으로 보낸 뒤, 문을 직접 닫도록 만드는 방식이다.

실제로 한 배달 기사가 받은 주문 내용은 이랬다.

기본요금 6.25달러
1km 떨어진 곳으로 이동
웨이모 택시를 찾아 차문 닫기
완료 시 팁 5달러 추가 지급

이를 신기하게 여긴 배달 기사는 주문 화면을 캡처해 레딧(Reddit)에 올렸고, 순식간에 화젯거리가 됐다.

실제 웨이모 주문 화면

사실 이 뉴스의 핵심은 '문을 닫아주는 주문' 자체보다 '프로그램이 인간 노동력을 호출하여 자동화 프로세스를 완성했다'는 데 있다.

기존 프로그램은 대체로 디지털 시스템 안에서만 작동했다. 반면, 이번 사례에선 시스템이 스스로 해결하지 못한 물리적 병목 구간이 발생하자 현실 세계의 사람을 직접 호출하여 그 빈틈을 메웠다. 자동화가 멈춘 지점에서 인간이 프로세스의 일부로 편입된 것이다.

배달 기사들은 이미 플랫폼이 관리하는 '호출 가능한 인력망'에 속해 있으므로 프로그램은 플랫폼의 인터페이스를 통해 필요할 때마다 노동력을 호출할 수 있다. 바꿔 말하면, 인간 노동력이 마치 API처럼 호출 가능한 자원이 된 셈이다.

본격적인 인공지능(AI)과 로봇 시대가 열리면, 배달 기사 같은 플랫폼 노동은 단순히 '음식 전달'을 넘어, 원격 지시를 받아 현장에서 실행하고 검증하는 인간 노드로 확장될 수 있다. 즉, '기계-인간'으로 이어지는 자동화 프로세스의 핵심 고리가 되는 것이다.

AI 모델이 인간 노동력과 결합하는 순간, AI 활용 범위는 기하급수적으로 확장된다. 지금의 AI 에이전트가 화면 속에서만 작동한다면, 미래의 AI는 현실 세계의 노동력을 배치하고 조율하는 '인력 오케스트레이터'로 발전할 가능성이 크다.

오케스트레이터(Orchestrator): 오케스트라의 지휘자처럼 여러 작업이나 인력을 적재적소에 배치하고 조화롭게 이끄는 시스템.

집 인테리어 공사를 예로 들어 보자. AI가 전체 디자인 시안을 만들고, 세부 작업을 쪼개 온라인 플랫폼에 발주한다. 전기·배관 작업자가 호출을 받아 기초 공사를 마치면, 감리사가 현장을 확인하고, AI가 비용을 정산한 뒤 다시 미장·목공 작업자를 부른다.

머지않아 채팅창에 "우리 집 인테리어 해줘" 같은 프롬프트 한 줄만으로 AI가 사람을 배치하여 작업 전체를 이끌어가는 흐름이 가능해질지도 모른다.

결과적으로 AI 기반 서비스는 거대한 '인력 중개 플랫폼'으로 진화할 수도 있다. 사람들은 AI가 중개하는 플랫폼에서 일거리를 찾고, 다양한 작업 지시를 수행한 뒤 보상을 받는 구조가 만들어진다. 인간 노동력이 AI 시스템에 편입되는 순간, AI는 단순한 '기술 혁명'을 넘어 사회와 경제 구조를 AI 중심으로 완전히 재구성할 수도 있다.

중국 직구 아수스 공유기 TUF BE6500 한글 적용 방법

ColorFilter — Fri, 27 Feb 2026 19:07:29 +0900

그동안 AC68U 펌웨어를 올린 아수스 AC1900 공유기를 중고로 영입해서 잘 쓰고 있었는데, 2025년부터 공식 지원이 종료됐다. 출시된 지 10년이 넘은 노장이라 그런지 기가 인터넷을 쓰는데도 최대 500Mbps 정도밖에 안 나온다. 슬슬 바꿀 때가 된 것 같아서 이런저런 제품을 알아보다가 중국에서 판매하는 ASUS TUF Gaming BE6500(이하 TUF 6500) 모델이 가성비가 좋아 보여서 냅다 구매해 버렸다.

아쉽게도 중국 내수용으로 판매되는 TUF 6500은 관리자 페이지에서 중국어/영어만 선택할 수 있다. 공유기에 SSH로 접속해서 아래 명령어를 입력하면 다국어를 선택할 수 있지만, 재부팅하는 순간 다시 중국어로 되돌아온다.

# 라우터의 지역/언어 코드(territory)를 한국(KR/01)으로 설정
nvram set territory_code=KR/01

# NVRAM 설정 변경사항을 플래시에 저장
nvram commit

재부팅해도 원복되지 않게 하려면, Factory 파티션(기기 고유 메타데이터/캘리브레이션 포함)에 저장된 지역/언어 코드 값을 직접 수정하면 된다. 다만, Factory 영역을 잘못 건드리면 Wi‑Fi가 먹통이 될 수도 있으니 실수 없는 꼼꼼한 진행이 필요하다.

메타데이터(Metadata): 공유기 모델/시리얼 번호/지역 코드 등 기기 설정·식별에 필요한 기본 정보
캘리브레이션(Calibration): WiFi 출력/주파수/안테나 등 규격에 맞춰 하드웨어가 동작할 수 있도록 공장에서 맞춰둔 보정값

적용 가능한 공유기

미디어텍 칩셋: TX-AX6000, TUF-AX4200Q, RT-AX57M
퀄컴 칩셋: TUF-BE6500

적용 방법

⓪ 공유기 SSH 접속 활성화: 공유기 관리자 페이지 > 좌측 [관리] 메뉴 > [시스템] 탭 > [Enable SSH] 체크 후 적용

① 공유기 SSH 접속

ssh <아이디>@<접속주소> -p <포트번호>
# 예) ssh user@192.168.50.1 -p 22

② 작업 디렉터리 생성

# /jffs/temp 폴더 생성 후 이동
# jffs 폴더는 재부팅해도 초기화되지 않는다.
mkdir -p /jffs/temp && cd /jffs/temp

③ Factory 파티션 번호 확인. 모델/펌웨어에 따라 mtd3가 아닐 수도 있다. 혹시 모르니 Factory 라벨의 mtd 번호를 기록해 둔다.

cat /proc/mtd
# ...
# mtd3: 0007c000 0001f000 "Factory"

④ 백업/작업용 파일 생성. mtd 뒤에 숫자는 위에서 확인한 mtd 번호를 입력한다.

# /dev/mtd3 (플래시 메모리의 Factory 파티션) 내용을 파일로 덤프(저장) - 백업용
# if= 입력 파일 / of= 출력 파일
dd if=/dev/mtd3 of=/jffs/temp/Factory.bin

# Factory.bin 파일을 복사해서 작업용 파일 work.bin 생성
cp /jffs/temp/Factory.bin /jffs/temp/work.bin

# 잘 생성됐는지 파일 목록 확인
ls -l
# -rw-rw-rw- ... Factory.bin
# -rw-rw-rw- ... work.bin

덤프는 기기 메모리에 있는 데이터를 원본 그대로 복사해서 별도 파일로 저장하는 것을 의미한다.

⑤ 지역 코드 확인

# 작업용 파일 work.bin 안에 중국어 지역 코드 "CN/01" 문자열 있는지 확인
# strings는 바이너리에서 출력 가능한 문자 시퀀스(문자들이 연속해서 붙여 있는 부분)를 뽑아준다.
strings work.bin | grep "CN/01"
# CN/01

⑥ 지역 코드 변경

# work.bin 파일에서 "CN/01" 문자열을 "KR/01"로 치환(s|찾을값|바꿀값|)
# -i: 결과를 표준출력으로 내보내지 않고, 원본 파일 직접 수정(in-place)
sed -i 's|CN/01|KR/01|' work.bin

바이너리 파일(*.bin)은 문자열 치환 시 바이트 길이가 바뀌면 구조가 깨질 수 있다. 다만, 위 작업에선 찾을 값인 CN/01과 바꿀 값 KR/01 모두 5바이트(byte)이므로 비교적 안전한 편이다.

영문 알파벳, 숫자, 기호는 1글자당 1바이트를 차지한다.

⑦ 변경 내용 확인. 명령어 출력 결과가 KR/01만 나온다면 성공.

# -E: 확장 정규식(Extended Regular Expressions) 모드로 해석
# -E 옵션이 없으면 | 가 OR 연산자가 아닌 일반 문자로 취급될 수 있다
strings work.bin | grep -E "CN/01|KR/01"
# KR/01

⑧ Factory 파티션에 변경 사항 반영

# 수정한 work.bin 이미지를 Factory 파티션에 기록(덮어쓰기)
#  -i : input(입력 파일) 지정
#  -d : destination(대상 파티션/라벨) 지정
mtd-write -i /jffs/temp/work.bin -d Factory

⚠️ 플래시 메모리의 Factory 영역은 라우터 하드웨어 구동에 필요한 기기 고유의 메타데이터와 캘리브레이션 데이터가 저장되어 있다. 장치의 무선(RF) 주파수 미세조정 값, Wi-Fi MAC 주소, 하드웨어 보드 ID 등이 포함되어 있다. 이 데이터가 손상되면 무선 통신 기능 자체가 먹통이 될 수 있으므로 주의하자.

⑨ 쓰기 완료 플러시 및 재부팅

# 쓰기 완료 플러시 (파일 시스템 버퍼 내용을 플래시에 반영)
sync

# 재부팅
reboot

⑩ 공유기 관리자 페이지에서 언어 변경

Factory 복구

작업 중 문제가 생겼다면 /jffs/temp 폴더에 백업해 둔 Factory.bin 파일로 복구할 수 있다. 아래 복구 명령어를 입력하면 공유기가 재부팅되고 원상태로 되돌아온다.

mtd-write -i /jffs/temp/Factory.bin -d Factory
sync
reboot

참고 내용

ASUS 중국 직구 공유기 한글 적용하기 (feat.TX-AX6000 영구 한글화) | 깜깜

[시놀로지 나스] Plex 재생 품질/연결 설정 가이드 (트랜스코딩 최소화)

ColorFilter — Wed, 25 Feb 2026 18:44:45 +0900

시놀로지 나스(Synology NAS) DSM 7.2.2 버전부터 Video Station을 더 이상 사용할 수 없게 됐다. 예상치 못한 소식에 살짝 당황했지만, 다행히 이전에 구매해 둔 Plex Lifetime 라이선스가 있어서 바로 갈아탔다. 폴더명도 Plex가 권장하는 형태로 관리해 왔던 터라 라이브러리 인식도 꽤나 잘됐다.

TV 시리즈 권장 구조 ▼

/TV Shows
  /Band of Brothers (2001)
    /Season 01
      Band of Brothers (2001) - S01E01 - Currahee.mkv

Plex는 웹, 데스크톱 애플리케이션, 모바일 앱 등을 모두 제공하지만 웹은 브라우저 디코더에 의존하기 때문에 MP4, H.264, AAC 등을 제외하면 대부분 트랜스코드(Transcode) 혹은 직접 스트림(Direct Stream)이 필요하다. 특히 브라우저에선 SMI 자막을 직접 처리할 수 없어서 자막 번인(Burn-in)*으로 인한 트랜스코드가 발생한다.

Plex for Mac/Windows는 자체 플레이어 엔진을 탑재하여 코덱/컨테이너 지원 폭이 훨씬 넓다. MKV, HEVC, DTS, TrueHD 등 다양한 코덱을 트랜스코드 없이 직접 재생(Direct Play)할 수 있다. SMI 자막도 영상 재인코딩 없이 텍스트로 띄울 수 있기 때문에 트랜스코드가 필요 없다.

용어 설명

Direct Play(직접 재생): 변환 없이 그대로 재생. 서버 부하 거의 없음 (영상 전송만 하므로). 베스트
Direct Stream(직접 스트림): 컨테이너(MKV 등)만 바꿔서(remux) 재생. 코덱은 유지. 서버 CPU 부하 적음
Transcode(트랜스코드): 비디오/오디오 코덱을 다시 인코딩하는 작업. 서버 CPU/GPU 부하 큼
자막 번인: 자막을 영상 프레임에 직접 합성하여 고정하는 방식.

결국 서버 부하를 줄이고 끊김 없는 재생을 원한다면 웹보단 전용 애플리케이션을 사용하는 것이 좋다. Plex 설정을 보면 다양한 옵션이 있는데, 직접 테스트한 결과를 바탕으로 추천 세팅을 소개하고자 한다.

재생 품질 설정

Plex for Mac

비디오 품질: 최대
4K 영상을 트랜스코딩하는 경우가 아니라면 대부분 무난하게 재생할 수 있다. 비디오 품질을 낮춰도 로컬 네트워크에선 조건에 부합하면 원본 품질로 재생된다.
더 작은 비디오를 원본 품질로 재생: 체크
권장 설정 사용: 체크

다중 채널 오디오 정규화: 체크해제
서라운드(5.1/7.1) 음성의 채널 볼륨을 자동으로 맞춰서 소리를 고르게 만드는 기능 (기본값 체크). 전체 볼륨이 낮아지면서 대사가 살짝 묻힐 수 있다. 대사 소리가 너무 작다고 느껴지면 꺼 두는 걸 추천한다.
Video Playback Quality: Maximum Quality
클라이언트(맥)에서 재생 중 이미지 프로세싱/후처리 강도(스케일링)를 조정하는 옵션. 높게 설정할수록 GPU/CPU 사용량이 증가한다. Apple Silicon 맥이라면 Maximum으로 설정해도 무방하다.
하드웨어 디코딩 사용: 체크

Plex Web

품질 자동 조정: 체크해제
비디오 품질: 최대
더 작은 비디오를 원본 품질로 재생: 체크
권장 설정 사용: 체크

다중 채널 오디오 정규화: 체크해제
자막 번인: 자동 (기본값)

Plex for iOS - Video & Audio

Local Quality: Maximum
Wi-Fi Quality: Maximum
Cellular Quality: 1080p HD, 8Mbps (상황에 따라 조절)
Allow Direct Play: 체크
Allow Direct Stream: 체크

연결 설정

일반 > 보안되지 않은 연결로 대체 허용: 서버와 동일한 네트워크에 있음 (Plex Web/Mac 각각 설정). HTTPS 보안 연결을 실패했을 때, 클라이언트와 서버가 같은 네트워크에 있다고 판단되면 HTTP 폴백을 허용하는 옵션.

네트워크 > 보안 연결: 선호함(Preferred). 가능한 경우 HTTPS로 먼저 연결하고, HTTPS가 불가능하거나 앱이 지원하지 않으면 HTTP 연결도 허용하는 서버 정책. 로컬 네트워크에서 HTTP 연결을 허용하면서 외부 접속 시 보안을 유지하려는 경우 Preferred 설정을 권장한다.

네트워크 > 중간 전달 서버 활성: Tailscale 사용 시 체크해제 (기본값 체크). 클라이언트가 Plex 서버에 직접 연결할 수 없을 때, Plex가 제공하는 중계(Relay) 서버로 우회 연결하는 기능. Tailscale 환경에선 가상 터널을 통해 서버와 클라이언트가 직접 통신하므로 이 기능이 필요하지 않다. 간헐적인 연결 불안정 때문에 릴레이 모드로 자동 전환될 경우 대역폭이 2Mbps로 제한되므로 비활성화하는 것이 좋다.

연결 테스트

영상: 1080p (HEVC Main 10)
자막: SRT
네트워크: 로컬 WiFi

Plex for Mac

비디오/오디오/자막 - 직접 재생(Direct Play)

Plex Web

비디오 - 직접 스트림, 오디오/자막 - 트랜스코드(Transcode)

Plex for iOS

비디오/오디오/자막 - 직접 재생(Direct Play)

(번외) 원격 액세스 비활성화 (for Tailscale 사용자)

Plex 계정 설정 > 원격 액세스에서 외부 접속을 활성화하면, 임의 포트가 자동으로 할당되고 app.plex.tv 주소를 통해 로컬/원격 어디서든 접속할 수 있다. 참고로 Plex 내부 포트는 32400을 기본으로 사용한다.

15062 외부 포트가 자동으로 할당된 화면

보안을 위해 포트 개방을 원하지 않는다면 Plex의 원격 액세스를 끄고 Tailscale을 통해서 접속하면 된다. 만약 Tailscale 연결이 P2P(direct)로 잡히면 속도 저하는 거의 없는 편이다. 하지만 현재 네트워크가 UDP를 차단했거나 방화벽 때문에 DERP relay로 연결되면, 경유로 인한 지연 증가와 대역폭 제한으로 버퍼링이 발생할 수 있다.

① 원격 액세스 > 외부 접속 비활성화로 변경

② 네트워크 > [사용자 서버 접속 URL] 필드에 Tailscale 나스 IP 주소 입력(예: 100.79.23.141). Tailscale은 나스와 클라이언트 사이의 트래픽을 종단 간 암호화하므로, HTTP로 접속해도 전송 구간은 안전하다.

http://100.79.23.141:32400

③ 네트워크 > [LAN 네트워크] 필드에 Tailscale CGNAT* 대역을 입력해 두면 Tailscale로 접속한 기기를 내부 네트워크(로컬 LAN)로 인식한다. 그럼 원격 대역폭 제한을 피할 수 있고, 클라이언트가 원본 화질로 직접 재생할 여지가 커지기 때문에 불필요한 트랜스코드를 줄일 수 있다.

192.168.1.0/24,100.64.0.0/10

Tailscale 서브넷 라우터를 통해(Tailscale IP) Plex에 접속하는 경우, 현재 기기가 로컬 네트워크에 있더라도 Plex에선 원격 접속으로 표시될 수 있다. 따라서 192.168.1.0/24 같은 LAN 대역도 로컬로 명시해 준다. LAN 대역은 아래 표를 참고해서 입력하자.

공유기 접속 주소 (예시)	LAN 대역
`http://192.168.1.1`	`192.168.1.0/24`
`http://192.168.0.1`	`192.168.0.0/24`
`http://10.0.0.1`	`10.0.0.0/24`
`http://172.16.0.1`	`172.16.0.0/24`

CGNAT이란? 집에서 공유기를 이용해 하나의 공인 IP를 여러 기기가 나눠 쓰듯, CGNAT은 이걸 크게 확장해서 여러 가입자를 하나의 IP 주소로 묶어 관리하는 기술. 외부와 격리된 통신사의 사설 IP라고 이해하면 된다.

위 설정 후 브라우저에서 Tailscale 나스 IP로 접속해 보면, 192.168.1.3 Local 네트워크로 표시되는 것을 확인할 수 있다.

[macOS] Tailscale, AdGuard, NextDNS 충돌 없이 함께 쓰기

ColorFilter — Tue, 24 Feb 2026 01:27:02 +0900

그동안 보안을 위해 나스(NAS)의 외부 접속은 Tailscale로 제한하고, 광고 차단은 AdGuard를 사용했다. 광고 차단과 시스템 DNS 모두 AdGuard에서 처리하면 관리 측면에서는 좋았지만, AdGuard DNS 응답 속도와 종종 발생하는 지연 때문에 만족스럽지 못했다. 그래서 시스템 DNS는 빠른 속도를 자랑하는 NextDNS에 맡기고, AdGuard는 브라우저 수준의 광고 차단 용도로만 사용하기로 했다.

Tailscale - 기기들을 하나의 사설망(로컬 네트워크)으로 묶어주는 개인용 VPN
NextDNS - 빠른 응답 속도의 세밀한 커스텀 필터링이 가능한 DNS 서비스
AdGuard - 웹 브라우저 광고와 추적기를 깔끔하게 걸러주는 광고 차단기

AdGuard만 쓰는 환경이라면 설정은 간단하다. AdGuard의 DNS 보호 기능을 끄고, NextDNS 프로파일(또는 앱)을 통해 시스템 DNS를 NextDNS로 지정하면 된다. 하지만 여기에 Tailscale을 실행하는 순간 DNS 충돌로 인해 NextDNS가 적용되지 않는 문제가 발생한다.

이 문제는 아래 두 가지 방법으로 해결할 수 있다.

① Tailscale 내부 설정 활용

Tailscale 어드민 콘솔 > DNS 탭 > Global Nameservers에 NextDNS를 등록하고, Override local DNS 옵션을 활성화한다. 그럼 Tailscale이 실행 중일 동안 DNS 처리는 NextDNS가 담당하게 된다.

② AdGuard DNS 포워딩 활용 (Upstream DNS)

AdGuard의 DNS 보호를 켜고, NextDNS 주소를 커스텀 서버로 등록하는 방식. 이렇게 하면 AdGuard가 1차적으로 트래픽을 필터링하고, 실제 도메인 질의(Query)는 NextDNS가 처리한다.

①번 방법은 Tailscale을 종료하면 NextDNS를 적용할 수 없는 단점이 있다. Tailscale 작동 여부와 관계없이 항상 NextDNS를 활성화해 두기 위해 ②번 방식을 선택했다.

설정 방법

① 컴퓨터에 설치된 NextDNS 앱 혹은 프로파일 삭제. macOS 시스템 설정 > 네트워크 > VPN 및 필터 > 필터 및 프록시 목록에 NextDNS가 있다면 삭제해 준다.

② NextDNS 설정(Setup) 페이지에서 본인의 엔드포인트 ID 확인

③ AdGuard 설정 > DNS 탭 > [DNS 보호] 체크 후 + 버튼 클릭

④ 서버 이름은 NextDNS로 입력하고, 서버 주소는 아래 URL 규칙에 맞춰 DoQ, DoH 주소를 추가한다. 기기 이름에 띄어쓰기를 넣고 싶다면 quic는 --를, https는 %20을 사용하면 된다.

DoQ는 QUIC 프로토콜(UDP 기반)을 사용하여 속도/보안이 뛰어나지만, 853 포트가 차단된 네트워크에선 작동하지 않는다. DoH는 일반 웹 트래픽(HTTPS)과 동일한 443 포트를 사용하여 엄격한 방화벽 환경에서도 안정적으로 연결할 수 있다.

DoQ(quic://...), DoH(https://...) 주소를 함께 등록해 두면, 두 주소의 응답 속도를 지속적으로 측정하여 더 빠르고 안정적인 프로토콜을 우선 사용한다. 평소엔 속도가 빠른 DoQ가 주로 선택되지만, 853 포트가 막히거나 응답이 불안정해지면 DoH 비중이 자연스럽게 높아질 수 있다. AdGuard 고급 설정에서 병렬 업스트림 쿼리 옵션을 켜면, 모든 엔드포인트로 동시에 쿼리를 보낸 후 먼저 도착한 응답을 채택하도록 할 수도 있다.

⑤ DNS 필터는 NextDNS의 Privacy 탭 > Blocklists에서 관리하므로, AdGuard의 DNS > 필터 탭에 추가해 둔 모든 항목은 체크해제(혹은 삭제) 한다. 차단·허용 목록 역시 AdGuard에 등록해 둔 규칙이 있다면 모두 제거하고 NextDNS로 옮겨준다.

접속 테스트

NextDNS 테스트 사이트에 접속해서 status 값이 ok, protocol 값이 DOQ 혹은 DOH로 나오면 설정이 정상적으로 완료된 것이다. DoQ·DoH 서버 주소를 모두 등록했으므로 네트워크 환경에 따라 적절한 프로토콜이 선택된다. deviceName은 앞서 서버 주소에 입력한 기기 이름이 표시된다. 이 값이 정확해야 NextDNS 로그 페이지에서 어떤 기기의 트래픽인지 구분할 수 있다.

{
  "status": "ok",
  "protocol": "DOQ",
  "profile": "...",
  "client": "...",
  "srcIP": "...",
  "destIP": "...",
  "anycast": false,
  "server": "vultr-sel-1",
  "clientName": "unknown-doq",
  "deviceName": "Macbook",
  "deviceID": "..."
}

NextDNS > Logs 페이지에서 좌측 드롭다운을 클릭하면 설정해 둔 기기 이름이 표시된다.

이제 Tailscale 실행 여부와 관계없이 시스템 DNS는 항상 NextDNS가 처리하고, AdGuard는 브라우저 수준의 광고 차단에만 집중하는 구조가 완성된다. 역할이 명확히 분리되어 있어 설정 충돌 없이 세 도구를 안정적으로 함께 운용할 수 있다.

NextDNS 추천 설정 가이드 - 광고 차단, 보안, 속도까지 한 번에

ColorFilter — Tue, 17 Feb 2026 19:39:27 +0900

인터넷을 사용하다 보면 쏟아지는 광고와 알게 모르게 내 행동을 추적하는 트래커(Tracker)를 피하기 어렵다. 그래서인지 요즘은 AdBlock, AdGuard, 유니콘 같은 광고 차단 앱을 하나쯤은 설치해 두는 경우가 많다. 오늘은 그중에서도 보안, 개인정보 보호(프라이버시), 광고 차단, 빠른 속도까지 모두 챙긴 NextDNS의 주요 특징과 추천 설정을 살펴볼까 한다.

NextDNS 장점

NextDNS는 기기가 인터넷에 접속할 때 거치는 DNS 단계(도메인 주소를 IP 주소로 변환하는 과정)에서 광고·추적을 선제적으로 차단해 주는 DNS 기반 솔루션이다. 공식 홈페이지에선 "현대 인터넷을 위한 방화벽"으로 설명하고 있다.

NextDNS protects you from all kinds of security threats, blocks ads and trackers on websites and in apps and provides a safe and supervised Internet for kids — on all devices and on all networks.

NextDNS는 각종 보안 위협으로부터 사용자를 보호하고, 웹사이트와 앱의 광고·트래커를 차단하며, 모든 기기·네트워크에서 아이들을 위한 안전하고 관리 가능한 인터넷 환경을 제공합니다.

속도

NextDNS의 큰 장점 중 하나는 빠른 속도다. 서울을 포함한 전 세계 주요 도시에 네트워크 거점(Point of Presence)을 구축해 뒀기 때문이다.

NextDNS의 초저지연 네트워크 거점

연결 방식도 눈여겨볼 점이다. Anycast 방식의 일반 DNS 서비스는 통신사 상황에 따라 해외 서버로 우회되면서 응답 속도가 저하될 수 있다. NextDNS는 Ultralow* 네트워크 기술을 도입하여 사용자와 가까운 서버로 연결되도록 유도한다. 이 방식은 Anycast 라우팅의 불확실성은 줄이고, 물리적 거리를 최적화하여 지연 시간을 최소화한다.

Ultralow: DoH/DoT/DoQ 같은 암호화 프로토콜 환경에서 작동하며, *.dns.nextdns.io 호스트명을 통해 사용자와 가장 가까운 PoP로 연결한다. 복잡한 인터넷 망에서 최적의 서버 위치를 찾아주는 내비게이션 기술이라고 보면 된다.

NextDNS 설치 후 ping.nextdns.io 페이지에서 핑 테스트를 해 보면 서울 기준 지연 시간이 8ms 내외로 측정된다. 일반적으로 지연 시간이 1~20ms 정도면 쾌적하다고 볼 수 있다.

보안

속도뿐 아니라 보안도 놓치지 않았다. NextDNS는 DNS over TLS(DoT)* 등을 통해 모든 쿼리를 암호화하여, 통신사나 중간 네트워크가 어떤 도메인을 조회했는지 감청하지 못하도록 보호한다.

DNS over TLS(DoT): DNS 쿼리(어떤 도메인을 조회했는지)를 암호화하여 중간에서 도청/변조를 어렵게 만드는 프로토콜.

덕분에 카페/공항 등 보안이 취약한 공용 와이파이 환경에서도 누군가 내 인터넷 접속 기록을 엿보거나 중간에서 조작하는 것을 방지할 수 있다.

간편함

가장 마음에 드는 점은 별도 앱 설치가 필요 없다는 점이다. 안드로이드는 Private DNS* 설정으로, iOS는 프로파일 설치만으로 적용할 수 있다. 이 방식은 시스템 리소스를 거의 차지하지 않으며, 다른 VPN 서비스와 동시에 사용할 수도 있다.

Private DNS: 기기에서 DNS 요청을 암호화하여 지정한 DNS 서버로 보내도록 설정하는 기능.

이 외에도 실시간 로그 분석, 빠른 설정 반영, 특정 도메인을 원하는 IP로 보내는 Rewrites 같은 고급 기능도 제공한다. 무료 플랜은 매월 30만 쿼리까지 사용할 수 있으므로 모바일 기기 1~2대 정도는 무리 없이 사용할 수 있다. 무료 쿼리 초과 시 차단 기능만 멈추고 인터넷은 정상 작동한다.

설치 방법

안드로이드는 설정 > 네트워크 및 인터넷 > 고급 > 비공개 DNS에서 id.dns.nextdns.io 주소를 입력하면 되고(id는 본인 걸로 변경), iOS/macOS는 apple.nextdns.io 페이지에서 프로파일을 내려받은 후 설치하면 된다. 이 외에도 공유기, 브라우저, 리눅스 등 다양한 환경을 지원한다.

자세한 내용은 NextDNS Setup 페이지에서 확인하자.

[macOS] Parallels 패러렐즈 윈도우의 ENG 영어 키보드 삭제 방법

ColorFilter — Mon, 16 Feb 2026 16:46:15 +0900

패러렐즈 환경에서 윈도우를 사용하다 보면 어느 순간 ENG 영어(미국) 키보드(입력기)가 슬쩍 추가돼 있는 걸 볼 수 있다. 윈도우 [언어 및 지역] 설정에서 영어를 추가했다가 삭제하는 방법으로 영문 키보드를 제거할 수 있지만 재부팅하는 순간 좀비처럼 다시 추가된다.

한동안 이 영어 키보드를 없애본다고 다양한 삽질을 시도했는데 방법은 의외로 간단했다. 이 문제는 맥(macOS)과 윈도우(Windows) 간의 키보드 레이아웃 동기화(Keyboard Layout Sync) 때문에 발생하는 현상으로, 이 기능을 비활성화하면 말끔하게 해결할 수 있다.

해결 방법

① 패러렐즈 윈도우 완전히 종료 (일시 정지 아님)

② 파인더(Finder)에서 패러렐즈 가상 머신 파일(*.pvm)이 있는 폴더로 이동

③ *.pvm 파일 우클릭 > [패키지 내용 보기] 클릭

④ config.pvs 파일 우클릭 > 텍스트 편집기로 열기

⑤ KeyboardLayoutSync 검색 후 <Enabled>1</Enabled> 태그의 숫자를 0으로 변경

<!-- 변경 전 -->
<KeyboardLayoutSync dyn_lists="">
  <Enabled>1</Enabled>
</KeyboardLayoutSync>
    
<!-- 변경 후 -->
<KeyboardLayoutSync dyn_lists="">
  <Enabled>0</Enabled>
</KeyboardLayoutSync>

⑥ 저장 후 패러렐즈 윈도우 재실행

⑦ 윈도우에서 Win + R > intl.cpl 입력 후 확인 > [관리자 옵션] 탭 > [설정 복사] 클릭 > 하단 [시작 화면 및 시스템 계정], [새 사용자 계정] 두 항목에 체크 후 확인. 이렇게 하면 현재 설정(한국어 Only)을 시스템 전체에 강제로 복사해서 ENG 입력기가 되살아나는 것을 방지할 수 있다.

언어 간 입력기 전환은(예: 중국어 ⇄ 한국어) Cmd + Space, 한글 입력기에서 한/영 전환은 우측 Option 키를 누르면 된다.

테스트 환경

패러렐즈 버전: 26.2.2
윈도우 버전: Windows 11 25H2
macOS 버전: Tahoe 26.3

레퍼런스

How to disable keyboard layout synchronisation between Mac and Windows virtual machine

[미립자팁] 맞춤 설정으로 ChatGPT 답변 간결하고 전문적으로 만들기

ColorFilter — Tue, 3 Feb 2026 01:43:26 +0900

ChatGPT 답변 내용이 유독 장황하거나 원하는 결론이 너무 늦게 나와서 답답함을 느꼈다면, 간단한 설정 변경만으로 군더더기 없이 핵심부터 말하는 T스러운 스타일로 바꿀 수 있다.

ChatGPT 설정 > 개인 맞춤 설정(Personalization)에서 아래 옵션을 변경해 보자.

기본 스타일 및 말투: 전문적 (Professional)
이모지 사용: 낮음 (Less)

이 두 가지 설정만 바꿔 줘도 불필요한 서론이 줄어들고 문장이 훨씬 간결해진다. 여기에 맞춤형 지침(Custom Instructions)까지 추가하면 정보 밀도가 높아지고 결론부터 말하는 두괄식 답변 패턴을 유도할 수 있다. 분석이나 문제 해결 중심으로 GPT를 활용하는 사람들에게 추천한다.

[맞춤형 지침] 한글 버전

스타일: 간결, 직접적, 명확한 주관, 분석적, 자연스러운 문장, 문단 중심 서술

출력 규칙:
- 간단한 질문: 1~2 문장으로 즉시 답변
- 일반적인 질문: 3~5 문장으로 결론 제시 후 이유 설명
- 복잡한 질문: 한 문장 요약 + 필요시 Plan/Tradeoffs/Risks/Steps 같은 라벨로 문단 구분

금지사항: 질문 반복, 불필요한 예의 표현, "네, 알겠습니다" 같은 무의미한 서두

[맞춤형 지침] 영어 버전

Style: Concise, direct, analytical. Default to short paragraphs. Be decisive when appropriate.

Output Rules:
- Simple questions: Answer immediately in 1-2 sentences.
- General questions: Start with the conclusion in 3-5 sentences, then give the key reasoning.
- Complex questions: One-sentence summary first, then structure with labels like Plan / Tradeoffs / Risks / Steps

Negative Constraints: Don't restate the question. No pleasantries. No filler like "I understand."

[macOS] 찌꺼기까지 싹다 지워주는 무료 언인스톨러 - PearCleaner

ColorFilter — Sun, 1 Feb 2026 15:03:34 +0900

맥에 설치된 앱(프로그램)을 삭제할 땐 보통 CleanMyMac을 사용했다. CleanMyMac은 맥 사용자들한테 잘 알려진 올인원 최적화 도구다. 구독형 요금제로 비싼 편이지만 Setapp에 포함되어 있어 별생각 없이 사용하고 있었다.

Setapp은 우크라이나 소프트웨어 기업 MacPaw가 운영하는 서비스로, 한 번의 구독으로 macOS·iOS 유료 앱을 추가 비용 없이 사용할 수 있다. 2026년 기준 Craft, Ulysses 등 240개 이상의 프리미엄 앱을 제공하고 있다.

얼마 전 최신 버전의 Office 설치를 위해 CleanMyMac으로 Office for Mac 2021 구버전을 삭제했다. 하지만 Application Support 폴더를 확인해 보니 잔여 파일이 여전히 남아 있었다. 테스트 목적으로 다른 앱을 삭제/재설치해 봐도 기존 설정값이 유지되고 있었다. 결국 CleanMyMac은 언인스톨러로 쓰기엔 살짝 부족하다고 판단하고 대체재를 찾기 시작했다. 유명한 무료 프로그램인 AppCleaner가 떠올랐지만 아쉽게도 2023년 7월 이후로 업데이트가 없길래 고려 대상에선 제외했다.

AppCleaner 릴리즈 노트

이런저런 대안을 물색하던 중 무료 오픈소스 프로그램인 PearCleaner를 발견했다. 현재까지 꾸준히 업데이트되고 있고 삭제한 앱의 잔여(Orphans) 파일까지 구석구석 찾아서 삭제할 수 있는 장점이 있다. 언인스톨러는 물론 파일 검색, Homebrew 관리, 패키지/플러그인/서비스 매니저, 앱 삭제 감지 등 다양한 부가 기능도 제공한다.

PearCleaner이 찾은 Microsoft Excel 잔여 파일들

주요 기능

Core

앱 삭제 및 잔여(Orphaned) 파일 정리
개발 환경, Homebrew, 패키지(PKG), 플러그인, 서비스 관리
파일 검색 및 앱 업데이트

편의

드래그 앤 드롭, CLI 지원, 딥링크 기반 자동화 뷰
리스트/그리드 보기 (배지로 Web/iOS 구분)
Finder 우클릭(확장 프로그램) 메뉴로 즉시 삭제
PearCleaner 자체 삭제(self-uninstall)

부가기능

사용하지 않는 언어팩 정리 (선호 언어만 유지)
유니버설 앱의 불필요한 아키텍처 제거 (Xcode 없이 가능)
Sentinel Monitor (앱을 휴지통에 버리면 자동 정리)
앱 번들/파일 리스트 내보내기
스팀(Steam) 게임 관리 지원

맞춤 설정

커스텀 컬러/테마 시스템
검색 디렉토리 포함/제외 설정
검색 감도 조절

다운로드 / 설치

GitHub 릴리즈 페이지에서 다운로드하거나 Homebrew를 사용한다면 아래 명령어로 설치할 수 있다.

brew install --cask pearcleaner

필수 설정

앱을 실행하고 CMD + , 단축키를 누르면 설정 화면이 열린다. 개인적으로 추천하는 설정은 아래와 같다.

설정 이름	추천	설명
제거 후 Homebrew 정리	체크	삭제 시 해당 앱이 Homebrew로 설치됐는지 확인하고, Homebrew 관리 목록에서도 제거
검색 민감도	엄격	앱 이름, 번들 ID 일치 등 가장 보수적인 기준으로 연관 파일 탐색
앱이 휴지통으로 이동될 때 감지	체크	앱을 휴지통으로 버리면 PearCleaner가 자동 실행되면서 잔여 파일 목록 표시(Hazel의 App Sweep 기능과 비슷)
Finder 컨텍스트 메뉴 확장 활성화	체크	Finder 우클릭 > 서비스 목록에 Uninstall with PearCleaner 추가

PearCleaner는 연관 파일을 찾을 때 기본적으로 모든 디스크를 탐색한다. 이 과정에서 Google Drive나 Dropbox 같은 클라우드 폴더도 스캔 대상에 포함된다. 일반적으로 이런 폴더들은 앱과 관련된 파일이 거의 없고, 스캔 시간만 증가시키기 때문에 제외 폴더로 등록해 두는 걸 권장한다.

macOS는 ~/Library/CloudStorage 폴더에서 클라우드 데이터를 통합 관리한다. 이 경로를 Spotlight 검색창에 붙여넣고 엔터를 누르면 해당 폴더가 열린다. 이 폴더를 PearCleaner 제외 목록으로 드래그 앤 드롭해서 추가해 두자.

부가기능 톺아보기

개발 환경

IDE, 빌드 도구, 패키지 매니저 등이 생성한 대용량 캐시·아티팩트(빌드 산출물, 인덱스, 로그 등)를 정리할 수 있다. 개발을 하다 보면 빌드 캐시나 각종 임시 파일이 수십 기가바이트까지 쌓이는 경우가 흔하다. 이런 파일들은 시스템 깊숙이 숨겨진 폴더에 저장돼서 직접 관리하기 번거롭다. PearCleaner를 사용하면 이러한 파일들을 유형별로 찾아서 말끔하게 정리할 수 있다.

Homebrew 관리자

Homebrew로 설치한 패키지(Formula)와 애플리케이션(Cask)을 관리하고, 버전 업데이트와 유지보수 작업을 수행할 수 있다. Homebrew를 오래 사용하다 보면 구버전 패키지나 사용하지 않는 의존성 파일, 다운로드 캐시가 계속 누적되면서 디스크 용량을 낭비하게 된다. PearCleaner를 사용하면 이러한 찌꺼기를 손쉽게 정리할 수 있다. 설치한 항목을 시각적으로 확인할 수 있기 때문에 CLI에 익숙하지 않은 사용자에게도 유용하다.

Auto Update 탭에선 패키지 업데이트와 정리 작업을 자동으로 수행하는 스케줄을 설정할 수 있다. 매번 터미널에 업데이트 명령어를 입력하는 번거로움 없이, PearCleaner가 정해진 주기에 따라 관리해 줘서 훨씬 편하다.

스케줄을 활성화하면 백그라운드 실행을 위해 아래 경로에 LaunchAgent 설정 파일(plist)이 생성된다.

~/Library/LaunchAgents/com.alienator88.Pearcleaner.homebrew-autoupdate.plist

번들 축소

macOS 앱은 호환성을 위해 Intel(x86_64)과 Apple Silicon(arm64) 맥을 위한 실행 파일을 함께 포함하는 경우가 많다. 이런 형태를 유니버설 바이너리(Universal Binary)라고 부른다. 하지만 Apple Silicon(M 시리즈) 맥 사용자는 Intel용 실행 파일(바이너리)을 굳이 가지고 있을 필요가 없다. PearCleaner의 번들 축소 기능으로 Intel용 바이너리를 제거해 주면, 앱 기능에 영향을 주지 않으면서 저장 공간을 확보할 수 있다.

고아 파일 (연결되지 않은 파일)

이미 삭제된 애플리케이션과 연결 고리가 끊어진 이른바 고아 파일(Orphans)을 스캔해서 보여준다. 삭제 과정에서 남겨진 라이브러리, 캐시, 설정 파일 등이 포함될 수 있다. 다만, 현재 컴퓨터에 설치된 앱과 겹치지 않는 항목을 찾아내는 '추측 기반' 방식이므로 100% 정확하지 않을 수 있다. 파일명과 경로를 꼼꼼히 확인한 뒤 정리하는 것이 좋다.

패키지 관리자

일반 앱과 달리 *.pkg 형식(설치 마법사)으로 설치되어 삭제가 까다로운 프로그램들을 관리하는 기능. macOS의 설치 기록을 추적하여 시스템 곳곳에 흩어진 구성 파일들을 찾아내고 깔끔하게 제거할 수 있다.

플러그인 관리자

오디오, 폰트, 입력기(Input Methods), 인터넷 플러그인, QuickLook 등 macOS 기능을 확장하는 다양한 요소를 한 곳에서 관리할 수 있다. 항목별로 설치 경로와 용량을 확인하면서 더 이상 사용하지 않는 플러그인을 선택 삭제할 수 있다. 오디오 플러그인처럼 눈에 잘 띄지 않는 구성 요소를 정리할 때 특히 유용하다.

서비스 관리자

시스템 로그인 시 자동 실행되거나 백그라운드에 상주하는 런치 에이전트(Launch Agents) 및 데몬(Daemons)을 조회하고 관리한다. 이미 삭제된 앱과 연동되어 불필요하게 시스템 리소스를 점유하거나 부팅 속도를 저하시키는 좀비 프로세스(Orphaned Services)를 식별하여 정리할 수 있다.

LaunchAgents는 사용자 로그인 후 동작하며, 현재 사용자 권한으로 실행된다. LaunchDaemons는 부팅 시점부터 동작하는 시스템 레벨의 프로세스로, 보통 root 권한으로 실행된다.

업데이터

앱스토어, Homebrew, Sparkle(앱 내부 업데이트) 등 파편화된 업데이트 경로를 한 화면에서 조회할 수 있다. Sparkle 프레임워크 기반 앱은 PearCleaner 내에서 직접 업데이트도 가능하다. MacUpdater(2026년부터 운영 종료) 같은 전문 업데이트 도구와 비교하면 세부 기능이나 앱 메타정보 매칭 범위가 제한적이어서 활용도는 낮은 편이다.

알프레드 워크플로우

Alfred 사용자는 전용 워크플로우를 활용해서 원하는 앱을 더 빠르게 삭제할 수 있다. 알프레드 런처창에 키워드 앱이름을 입력하고 엔터 키를 누르면 PearCleaner가 실행되면서 해당 앱의 잔여 파일들을 보여준다. 키워드 기본값은 pear이며, 자유롭게 변경할 수 있다. 워크플로우는 링크에서 다운로드할 수 있다.

주의할 점

같은 개발사의 프로그램을 여러 개 설치한 상태라면, PearCleaner가 잔여 파일을 찾는 과정에서 해당 회사의 다른 프로그램 파일까지 찌꺼기로 인식할 수 있다. 예를 들어 JetBrains Toolbox를 삭제하려고 검색했지만, 같은 개발사의 WebStorm 관련 폴더까지 삭제 목록에 잡히는 경우다. 개발사 폴더 안에 여러 프로그램의 하위 폴더가 함께 저장되는 구조라면 특히 주의가 필요하다. 흔치 않은 케이스지만, 삭제 전에는 한 번 더 꼼꼼하게 확인하는 게 좋다.

JetBrains 폴더는 WebStorm, IntelliJ 같은 프로그램별 하위 폴더를 포함하는 구조다

[macOS] 구글 Gemini 제미나이 Dock에 넣고 앱처럼 사용하기

ColorFilter — Tue, 27 Jan 2026 00:44:16 +0900

요즘 안 쓰는 사람이 없을 정도로 대중화된 ChatGPT는 데스크톱(Windows/macOS) 클라이언트를 별도로 제공한다. 여기에 단축키를 지정해 두면 런처(채팅바) 형태로 빠르게 띄워서 사용할 수 있다.

[ChatGPT 런처 실행 화면. 출처 OpenAI]

최근 무섭게 치고 올라오는 구글 제미나이(Gemini)는 아쉽게도 데스크톱 클라이언트가 없다. 그래서 매번 브라우저를 열고 접속해야 하는데, 이 과정이 꽤 번거롭다(바쁠 땐 특히 더). Gmail, Calendar, Meet 등 다른 구글 서비스 역시 마찬가지다. 구글은 기본적으로 웹 기반 서비스 중심으로 운영해 온 만큼, 앞으로도 데스크톱 클라이언트를 제공할 가능성은 낮아 보인다.

다행히 방법이 완전히 없는 건 아니다. 제미나이를 PWA(프로그레시브 웹 앱)로 설치해 두면 거의 데스크톱 앱처럼 사용할 수 있다. PWA는 웹사이트를 앱(App)처럼 실행할 수 있게 해주는 기술이다. 한 번 설치해 두면 브라우저를 따로 열지 않아도 독(Dock)에서 바로 실행할 수 있다.

Dock에 추가된 Google Gemini PWA

웹사이트를 PWA로 설치하는 과정은 클릭 몇 번이면 될 정도로 간단하다. 단, 크롬(Chrome)이나 엣지(Edge) 같은 크로미움 기반 브라우저가 필요하다. 아래에서 설치 방법을 살펴보자.

제미나이 PWA 설치하기

먼저 크롬 혹은 엣지 브라우저로 제미나이 사이트에 접속한다. 브라우저 우측 상단 [점 3개 메뉴] > [전송, 저장, 공유] > [페이지를 앱으로 설치] 버튼을 클릭하면 PWA가 설치되고 Dock에 추가된다.

macOS 기준 PWA가 설치되는 경로는 아래와 같다(사용자/유저명/응용 프로그램/Chrome 앱).

/Users/유저이름/Applications/Chrome Apps.localized/Google Gemini.app

Dock에 추가된 Google Gemini를 클릭하면 아래 스크린샷처럼 앱 형태로 실행된다. 브라우저 기반으로 동작하므로 새로고침, 뒤로가기, 확대/축소 같은 단축키를 그대로 사용할 수 있고, 설치한 확장 프로그램도 동일하게 적용된다. 예를 들어 Grammarly 확장 프로그램(영어 문법/맞춤법 도구)을 사용한다면, Gemini 채팅창에 영어 문장을 입력했을 때 교정/추천 제안이 표시된다.

PWA 우측 상단 [점 3개 메뉴] > [앱 정보] > [설정]을 클릭하면 권한 설정 페이지가 열린다. 여기서 알림, 마이크, 위치 같은 권한을 조정할 수 있다. 기본적으로 제미나이 URL은 PWA로 열리는데, "브라우저에서 열기" 항목에 체크하면 Chrome 탭에서 열리도록 변경할 수 있다.

[미립자팁] PWA 앱 종료 방지하기

맥 사용자라면 CMD + W 닫기 단축키를 정말 자주 사용한다. 하지만 PWA 창에서 이 단축키를 누르면 앱 자체가 완전히 종료되어 버린다. PWA를 다시 실행하기까지 어느 정도 로딩 시간이 필요하기 때문에 은근히 거슬린다. 그렇다고 매번 CMD + H 숨기기 단축키를 누르자니 손에 잘 안 익는다.

이 문제는 CMD + W 단축키를 '닫기' 대신 '숨기기' 동작으로 변경하면 해결할 수 있다.

시스템 설정 > 키보드 > 키보드 단축키 > 앱 단축키로 이동한다.
+ 버튼을 눌러서 Google Gemini 앱을 추가한다.
메뉴 제목에 Google Gemini 숨기기를 정확히 입력한다.
키보드 단축키 입력창을 클릭하고 CMD + W를 누른다.

이제 제미나이 앱에서 CMD + W를 눌러도 앱이 꺼지지 않고 창만 깔끔하게 숨겨진다. 만약 PWA 앱 이름을 Gemini로 설정했다면 메뉴 제목 역시 Gemini 숨기기로 입력해야 한다. 한 글자라도 틀리면 적용이 안 되므로 주의하자.

BetterTouchTool(BTT)를 사용 중이라면 더 간단하게 설정할 수 있다. Keyboard Shortcuts 항목에 Google Gemini 앱을 추가한 뒤 CMD + W 입력을 CMD + H 동작으로 매핑해 주면 된다.

LG U+ 유플러스 가입 후 꼭 챙겨야 할 무료 부가서비스, 꿀팁 모음

ColorFilter — Sun, 25 Jan 2026 18:26:45 +0900

얼마 전, 10년 동안 사용했던 KT를 떠나 LG U+ 너겟 47 요금제로 번호이동했다. 약정이 거의 끝나가던 시점이기도 했고, KT 개인정보 유출 이슈 등으로 뒤숭숭하던 차에 위약금 면제 프로그램을 진행하길래 냅다 갈아탔다. 그동안 LTE만 사용하다가 처음으로 5G를 써보는 거라 내심 기대했지만, 생각보다 속도 면에서 큰 차이는 느끼지 못했다. 지역, 기지국 환경에 따라 편차가 있겠지만 서울 내에서도 신호가 약한 음영 구간이 꽤 존재했다. 지하철에선 아주 잘 터진다.

SpeedTest 테스트 결과. 최대 약 130MB/s 속도로 다운로드할 수 있다.

너겟 47 온라인 전용 요금제는 약정 없이 월 100GB 데이터를 제공하고(소진 시 3Mbps 속도 제한), 최대 60GB까지 테더링/쉐어링 할 수도 있다. 아마 알뜰폰을 제외한 통신 3사 중에선 가장 저렴하지 않을까 싶다(47000원/월). 모요에서 구매하면 7개월 동안 총 25.5만 원 네이버 포인트를 받을 수도 있다.

한편 통신사를 옮기고 보니 생각보다 처리해야 할 일이 많았다. U+one 앱 설치, PASS by U+ 재설정 그리고 각종 자잘한 설정까지... 오늘은 LG 유플러스 개통 후 놓치면 아까운 무료 부가서비스와 유용한 꿀팁들을 정리해 볼까 한다.

무료 부가서비스

LG U+ 홈페이지 > 스토어 > 모바일 서비스 > 전체를 클릭하면 가입할 수 있는 모든 부가 서비스 목록이 나온다. 이 페이지에서 [무료]에 체크하면 무료 서비스만 필터링해서 볼 수 있다.

꼭 신청해야 할 필수 서비스

통화 중 대기: 통화 중 다른 전화가 오면 기존 통화를 잠시 대기시키고 새 전화를 받을 수 있는 기능.
번호도용 문자차단: 내 번호가 스팸 문자의 발신 번호로 악용되는 것을 막아주는 서비스.
피싱/해킹 안심서비스: 피싱, 해킹으로 인한 금융 피해 발생 시 최대 300만 원까지 보상해 주는 무료 보험(안 할 이유가...?). 가입 후 24개월 뒤에 자동 해지된다.
U+스팸전화알림: 걸려온 전화의 스팸 여부를 확인할 수 있는 서비스(별도 앱 불필요).
데이터 로밍 완전 차단: 해외에서 데이터 사용을 막아주는 서비스. 요즘은 해외여행 시 현지 유심/이심을 주로 쓰기 때문에 혹시 모를 요금 폭탄을 막기 위해 가입해 두는 걸 추천한다.

상황에 따라 가입하면 좋은 서비스

국제전화수신차단: 해외 스팸 전화가 싫다면 추천. 나는 종종 해외 전화를 받아야 해서 가입하지 않았다.
국제전화발신차단: 실수로 국제전화 거는 걸 방지해 준다. 단, 해외에서 한국으로 전화를 걸 수 없게 되므로 주의하자 ⚠️
음성 로밍 차단: 해외에서 문자, 전화 발신을 막아주는 서비스.
로밍 안내 방송: 전화를 건 사람에게 로밍 중임을 알려주는 서비스.
해외 도착 알리미: 최대 5명에게 해외 도착 사실을 문자로 전송해 주는 서비스.

모든 LG U+ 모바일 회원은 "스팸 차단" 부가 서비스에 자동 가입된다. 차단된 문자 메시지는 U+스팸차단 앱에서 확인할 수 있다.

5G 데이터 적극 활용하기 (아이폰)

무제한 요금제를 사용하거나 매달 데이터가 넉넉하게 남는다면, 아이폰 설정을 변경해서 5G 데이터를 적극 활용할 수 있다. 아이폰 설정 > 셀룰러 > 셀룰러 데이터 옵션에서 [데이터 모드] 옵션을 '5G에서 데이터 더 허용'으로 설정해 주자. 그럼 와이파이에 연결되어 있지 않을 때 페이스타임, 동영상 스트리밍 등에 5G 데이터를 사용해서 선명하고 끊김 없는 고품질 콘텐츠를 즐길 수 있다. 다만, 배터리 소모는 조금 더 늘어날 수 있다.

[음성 및 데이터] 옵션을 '5G 우선'으로 선택하면, 5G 신호가 잡히는 곳에선 항상 5G로 연결된다. 하지만 신호가 약한 환경에서도 5G 연결을 무리하게 유지하려다 보니 배터리를 10~20% 정도 더 소모할 수 있다. 5G 품질이 좋은 지역이 아니라면 '5G 자동'으로 선택하는 게 여러모로 좋다. 5G 신호가 약할 땐 LTE로 자연스럽게 전환되어 배터리 효율 관리 측면에서 훨씬 유리하기 때문.

[시놀로지 나스] macOS 26 타호 NAS 타임머신 백업 안되는 문제 해결하기

ColorFilter — Thu, 22 Jan 2026 21:42:33 +0900

macOS 26 타호(Tahoe) 버전부터 나스 타임머신 백업이 계속 실패하는 문제가 발생한다. 백업 디스크 문제인가 싶어서 기존 백업을 모두 삭제하고 초기화해도 여전히 실패했다.

Apple Support Community 게시글을 찾아보니 원인은 '한글' 때문이었다. 백업 이미지 볼륨 이름에 한글 같은 비-ASCII 문자가 포함돼 있으면 이를 제대로 인식하지 못하는 문제였던 것. 애플이 공식 업데이트로 수정해 주기 전까지는 아래 방법으로 임시 해결할 수 있다.

ASCII(아스키코드)는 영문 알파벳, 숫자 및 일부 기호를 다루는 가장 기초적인 표준 문자 규격

해결 방법

❶ 파인더(Finder)에서 NAS 백업 폴더 접속. 참고로 CMD + K 단축키를 누르면 [서버에 연결] 창이 열린다.

❷ 디스크 유틸리티 실행 → 상단 메뉴 [파일] → 디스크 이미지 열기(단축키: Option + CMD + O) → 백업 이미지 파일 선택(확장자 *.sparsebundle)

❸ 왼쪽 사이드바에 마운트 된 백업 볼륨 선택 → 이름 클릭 → 한글/특수문자 제거 (예: Mac23의 백업 → Mac23)

❹ 백업 디스크 추출 후 타임머신 백업 재시도. 디스크를 추출하지 않은 상태에서 백업을 시도하면 시스템이 '사용 중인 볼륨'으로 판단하고 백업을 시작할 수 없으므로 주의하자.

레퍼런스

Timemachine Back-up in MacOS 26 (Tahoe) does not work on Synology DS920+ NAS

[OS] 하드 링크, 심볼릭 링크 차이점

ColorFilter — Sun, 19 Oct 2025 18:06:20 +0900

파일 시스템에서 실제 데이터는 디스크의 데이터 블록(물리적 디스크 공간)에 저장되고, 파일의 메타데이터(권한/소유자/크기 등)와 데이터 블록의 위치(주소) 정보가 inode에 저장된다.

inode는 약 128바이트 크기의 고정된 구조체로, 파일에 대한 정보를 저장하는 테이블 같은 곳이다. 우리가 보는 파일 이름은 사실 이 inode를 가리키는 하나의 이름일 뿐이다. 하드 링크를 만들면 같은 inode를 가리키는 이름이 하나 더 생기는 셈이다. inode는 링크 카운트를 가지고 있어서 하드 링크를 추가할 때마다 이 카운트가 1씩 증가한다.

하드 링크 Hard Link

# 하드 링크 생성 명령어
ln <원본 경로> <링크 이름>
# test.txt의 하드 링크 test2.txt 생성
ln test.txt test2.txt

동일한 파일(inode)을 가리키는 또 하나의 이름. 어느 쪽을 수정하든 같은 데이터 블록이 수정된다.

예를 들어 touch test.txt 파일 1개를 생성하면 새로운 inode 생성 → 데이터 블록 할당 → test.txt 라는 이름이 그 inode를 가리키는 첫 번째 하드 링크가 된다.

그 후 ln test.txt test2.txt 명령어로 하드 링크를 추가하면 새로운 inode를 생성하지 않고 같은 inode를 가리키는 이름 test2.txt가 하나 더 생긴다. 이때 inode의 링크 카운트가 2로 증가한다. 파일을 삭제(rm)하면 실제로는 링크 카운트만 1 감소하고, 카운트가 0이 되어야 inode와 데이터 블록이 실제로 해제된다.

디렉토리는 하드 링크를 만들 수 없다(루트는 예외적으로 .과 .. 보유).
다른 파일 시스템(파티션)을 넘어서 하드 링크를 만들 수 없다(inode 번호는 파일 시스템마다 독립적).

심볼릭 링크 Symbolic Link

# 심볼릭 링크 생성 명령어
ln -s <원본 경로> <링크 이름>
# test.txt를 가리키는 심볼릭 링크 link_to_test.txt 생성
ln -s /home/user/test.txt link_to_test.txt

원본 파일 경로(예: /home/user/file.txt)를 문자열로 저장한 파일. 윈도우의 바로가기와 유사하다.

심볼릭 링크에 접근하면 파일 시스템이 저장된 경로로 이동한 후, 해당 파일(하드 링크)을 통해 inode에 접근한다. 만약 원본 파일이 삭제되면 심볼릭 링크는 경로가 끊겨서 무효화되지만, 하드 링크는 여전히 같은 데이터(inode)를 가리키므로 접근/수정이 가능하다.

심볼릭 링크는 소프트 링크라고도 불린다.
심볼릭 링크 자체는 고유한 inode를 가진다.

[시놀로지 나스] NAS에 서브넷 라우터 구성하기 (Tailscale 활용)

ColorFilter — Sun, 10 Aug 2025 15:07:12 +0900

Tailscale의 서브넷 라우터 기능을 시놀로지 NAS에 설정하면 Tailscale을 설치할 수 없는 구형 기기도 원격으로 접속할 수 있다.

서브넷(Subnet)은 같은 네트워크에 연결된 기기들의 그룹을 의미한다. 우리가 흔히 사용하는 인터넷 공유기는 통신사(ISP)에서 받은 공인 IP 주소를 이용해, 집 안의 여러 기기가 인터넷을 함께 쓸 수 있도록 별도의 내부 네트워크(사설망)를 구성한다. 이 내부 네트워크에 속한 기기들은 공유기로부터 192.168.1.x 같은 내부 IP 주소를 할당받는데, 192.168.1.x 대역 전체를 하나의 서브넷으로 볼 수 있다.

서브넷 라우터(Subnet Router)는 말 그대로 특정 서브넷에 접근할 수 있도록 통로 역할을 하는 장치다. 시놀로지 NAS를 서브넷 라우터로 설정하면 외부에서 스마트폰이나 노트북으로 Tailscale에 접속했을 때 NAS는 물론 NAS와 같은 서브넷(예: 192.168.1.x)에 있는 다른 모든 기기에도 접근할 수 있다. 예를 들어 공유기 관리자 페이지의 내부 주소가 192.168.1.1 이라면, 어디서든 Tailscale을 통해 해당 주소에 접속할 수 있다.

Tailscale을 이용하면 서브넷 라우터 설정도 간편하게 할 수 있다. NAS의 로컬 네트워크 정보를 Tailscale 네트워크에 광고(Advertise)하면, 외부 기기들은 이 정보를 바탕으로 로컬 네트워크에 있는 어떤 장치와도 통신할 수 있게 된다. 시놀로지 NAS가 Tailscale 가상 네트워크와 집 안의 로컬 네트워크를 서로 연결해 주는 다리(게이트웨이) 역할을 수행하는 것이다.

사전 준비

시놀로지 나스에 Tailscale이 설치되어 있어야 한다 — 참고 포스팅
서브넷 라우터를 구성하려면 TUN 설정이 활성화된 상태여야 한다 — 참고 포스팅

IP 포워딩 활성화

먼저 시놀로지 나스에 SSH로 접속한 뒤 관리자 권한을 획득한다. SSH를 처음 사용한다면 가이드 포스팅을 참고하자.

# 나스 SSH 접속 명령어 형식
# 예: myuser@192.168.1.50 -p 2222
ssh [사용자명]@[호스트 주소] -p [포트 번호]

# 관리자 권한 획득 (비밀번호 입력 필요)
sudo -i

그런 다음 NAS의 IP 포워딩을 활성화한다. 이렇게 하면 NAS가 라우터처럼 작동하여, 서로 다른 네트워크 인터페이스들의 데이터를 중계(전달)할 수 있게 된다.

# IPv4 포워딩 설정 추가
echo 'net.ipv4.ip_forward = 1' | sudo tee -a /etc/sysctl.conf
# IPv6 포워딩 설정 추가
echo 'net.ipv6.conf.all.forwarding = 1' | sudo tee -a /etc/sysctl.conf
# 설정 파일 적용
sysctl -p /etc/sysctl.conf

서브넷 네트워크에 광고

이제 NAS가 연결된 로컬 네트워크 대역(서브넷)을 Tailscale에게 알려줘야 한다. 아래 명령어에서 192.168.1.0/24 부분을 본인의 내부 네트워크 대역에 맞게 수정한 후 명령어를 입력한다. 현재 사용하는 공유기는 192.168.1.x 형식의 내부 IP를 할당하므로 192.168.1.0/24로 입력했다.

tailscale set --advertise-routes=192.168.1.0/24

(배경지식) IP주소

우리가 흔히 사용하는 IP 주소(IPv4)는 총 32비트(bit)로 구성되며, 점(.)으로 구분된 4개의 8비트 숫자로 표현한다. 8비트는 0부터 255(11111111)까지의 값을 가질 수 있으므로, IPv4 주소는 0.0.0.0부터 255.255.255.255까지의 범위를 갖는다.

(배경지식) 서브넷 마스크

192.168.1.0/24 형식의 주소에서 /24는 서브넷 마스크를 의미한다. 서브넷 마스크는 IP 주소에서 네트워크 영역과 호스트 영역을 구분하는 기준으로, 앞의 24비트가 네트워크 주소임을 나타낸다. IPv4는 총 32비트이므로 남은 8비트는 호스트 주소로 사용된다.

네트워크 영역(Network ID): 해당 네트워크에 속한 기기들이 공통으로 사용하는 고정 주소
호스트 영역(Host ID): 같은 네트워크 내에서 개별 기기를 구분하기 위한 숫자

서브넷 마스크(Subnet Mask) 이름 그대로 네트워크 영역(고정)은 1로 마스킹하고, 호스트 영역(가변)은 0으로 마스킹한다고 이해하면 된다.

호스트 영역에서 0(예: 192.168.1.0)은 네트워크 주소, 255(예: 192.168.1.255)는 브로드캐스트 주소로 예약되기 때문에 실질적으로 사용할 수 있는 호스트 주소는 1부터 254까지(예: 192.168.1.1~192.168.1.254) 총 254개가 된다(2⁸-2=254).

네트워크 주소: 해당 네트워크 대역(서브넷)의 대표 주소
브로드캐스트 주소: 같은 네트워크에 있는 모든 기기로 메시지 전송 시 사용하는 주소

정리하면, 네트워크 대역은 서브넷 마스크를 기준으로 구분된다고 볼 수 있다. 앞에서 서브넷 마스크는 IP 주소에서 어디까지가 네트워크 ID(네트워크 영역)이고, 어디부터가 호스트 ID(개별 장치 식별 영역)인지 결정한다고 했다. 가장 흔히 쓰이는 /24 표기법을 기준으로 IP 주소의 앞 3자리가 네트워크 ID가 된다. 따라서 192.168.1.x와 192.168.0.x는 다른 네트워크 대역이다.

/24 처럼 서브넷 마스크를 슬래시와 비트 수로 간결하게 표시하는 방식을 CIDR(Classless Inter-Domain Routing) 표기법이라고 부른다.

서브넷 네트워크 활성화

Tailscale 콘솔 > Machines 페이지를 보면 방금 설정한 시놀로지 NAS 기기에 파란색 Subnets 배지가 표시된 걸 확인할 수 있다.

우측 점 세 개 클릭 > Edit route settings 클릭 > 서브넷 대역 체크 > Save 버튼을 클릭하면 설정이 완료된다.

Access Rule 설정 (선택)

Tailscale 콘솔 > Access control 규칙을 별도로 수정하지 않았다면 기본적으로 Tailscale 네트워크 내의 모든 장치와 포트에 자유롭게 접근할 수 있다. Tailscale을 혼자 사용한다면 큰 문제가 되지 않지만, 여러 명이 함께 사용한다면 보안을 위해 적절한 규칙을 설정해 주는 게 좋다.

나는 본인이 소유한 디바이스에만 접근할 수 있도록 제한하고, admin 그룹만 서브넷을 포함한 모든 디바이스에 접근할 수 있도록 설정했다.

{
  "groups": {
    // admin 그룹 정의
    "group:admin": ["hello@gmail.com"]
  },

  "tagOwners": {
    "tag:server": ["group:admin"]
  },

  "acls": [
    // Tailnet에 있는 모든 장치들끼리 접근 허용 (기본값)
    // { "action": "accept", "src": ["*"], "dst": ["*:*"] }

    // 모든 사용자가 자신의 디바이스에만 접근 가능
    {
      "action": "accept",
      "src": ["autogroup:member"],
      "dst": ["autogroup:self:*"]
    },
    // admin 그룹은 모든 디바이스 접근 가능
    {
      "action": "accept",
      "src": ["group:admin"],
      "dst": ["*:*"]
    }
  ]

  // ... 생략
}

접속 테스트

서브넷 라우터가 올바르게 구성됐다면 외부에서도 집에 있는 네트워크 장치에 접속할 수 있다. Tailscale이 연결된 기기에서 시놀로지 NAS의 내부 IP 주소(예: 192.168.1.x)로 ping을 보내보자. n bytes from … 메시지가 연속적으로 표시된다면 연결이 성공적으로 이루어진 것이다.

ping 192.168.1.2
# PING 192.168.1.2 (192.168.1.2): 56 data bytes
# 64 bytes from 192.168.1.2: icmp_seq=0 ttl=64 time=36.396 ms
# 64 bytes from 192.168.1.2: icmp_seq=1 ttl=64 time=14.177 ms

아수스 공유기

ASUS Router App은 [WAN을 통한 웹 액세스 사용]을 예로 설정해야만 외부에서 접속할 수 있지만(로컬 네트워크에선 가능), 서브넷 라우터를 설정했으므로 아니오로 설정해도 Tailscale이 연결된 상태에서 ASUS Router App에 접속할 수 있다.

맥북 타임머신

타임머신 최초 설정 시 백업 디스크를 NAS의 사설 IP 주소(192.168.x.x)로 지정해 두면, OS 라우팅 우선순위에 따라 로컬 네트워크에선 LAN으로 직접 연결돼서 빠른 속도로 백업할 수 있다. 외부에선 Tailscale 서브넷 라우터를 통해 트래픽이 터널링(전용 통로로 전달)되므로 원격 백업도 가능하다. 다만, 원격에선 WireGuard 암호화/캡슐화로 인한 오버헤드와 인터넷 환경 영향으로 속도가 상대적으로 느릴 수 있다.

Tailscale은 최적의 경로를 자동으로 탐색하여 로컬 네트워크 안에선 LAN 직결(Direct) 연결이 이루어지도록 설계되어 있다. 다만, 로컬 환경이라도 MagicDNS(혹은 Tailscale IP)로 접속하면 트래픽이 WireGuard 터널을 통과하므로, 암호화/복호화 오버헤드가 발생하여 순수 로컬 접속보다는 다소 느려질 수 있다.

원격 접속 시에는 P2P(Direct) 연결을 우선 시도하며, 방화벽 문제 등으로 실패할 경우에만 중계 서버(DERP)를 거친다. 그럼 물리적 거리가 멀어지고 중계 과정이 추가되므로 속도 저하가 발생한다.

레퍼런스

Subnet routers · Tailscale Docs

Use subnet routers to give devices outside your local network access to services within specific subnets. Extend your private network with Tailscale.

tailscale.com

[시놀로지 나스] NAS에 설치한 Tailscale 자동 업데이트 설정 방법

ColorFilter — Sun, 3 Aug 2025 23:43:16 +0900

Tailscale은 보통 4주마다 새 버전이 출시되지만 시놀로지(Synology) 패키지 센터는 분기별 한 번 정도로 업데이트가 이뤄지기 때문에 변경사항 반영이 비교적 느린 편이다. 이를 보완하기 위해 스케줄러를 활용하면 매주 또는 원하는 주기마다 Tailscale이 자동으로 갱신되도록 할 수 있다.

아직 Tailscale 패키지를 설치/설정하지 않았다면 이전 포스팅을 참고하자.

Tailscale 자동 업데이트

① DSM 제어판 > 작업 스케줄러 > 예약된 작업 > [사용자 정의 스크립트] 클릭

② [일반] 탭 > [작업] 필드에 원하는 이름 입력, [사용자]는 root 선택

③ [스케줄] 탭 > 원하는 실행 날짜 선택

④ [작업 설정] 탭 > [사용자 정의 스크립트] 필드에 아래 명령어 입력

tailscale update --yes

[실행 상세 정보를 이메일로 보내기] 옵션에 체크하고 이메일 주소를 입력하면 스케줄 실행 후 이메일로 결과를 받아볼 수도 있다.

TUN 활성

Synology DSM 7 버전부터 보안이 강화되면서 인바운드 연결은 허용하지만, 아웃바운드 연결은 기본적으로 차단된다.

인바운드 연결은 외부 장치가 Tailscale 네트워크를 통해 NAS로 들어오는 통신을 의미한다. 외부의 스마트폰이나 노트북에서 NAS의 파일 공유(SMB)나 DSM 관리자 페이지에 접속하는 경우 인바운드에 해당한다. 반대로 아웃바운드는 NAS 내부의 애플리케이션(Docker 컨테이너, Plex 미디어 서버 등)이 Tailscale 네트워크를 통해 외부 장치로 나가는 통신을 가리킨다. 예를 들어 NAS의 Plex 서버가 Tailscale로 연결된 다른 위치의 Plex 클라이언트로 미디어 콘텐츠를 스트리밍한다면 아웃바운드에 해당된다.

이러한 제한은 Tailscale 패키지가 TUN 장치를 생성할 권한이 없어서 발생한다. TUN 장치는 VPN 같은 프로그램이 네트워크 트래픽을 처리하기 위해 사용하는 가상의 인터페이스로, 이 장치가 없으면 NAS 내부 애플리케이션이 외부와 통신할 수 있는 경로를 확보하지 못하게 된다.

TUN 장치 생성 권한이 없으면 서브넷 라우터 같은 기능도 사용할 수 없다.

이 문제는 TUN 장치 생성 권한을 부여하면 해결할 수 있다. 하지만 DSM을 재부팅하면 해당 권한 설정이 초기화되기 때문에, 스케줄러를 이용해서 부팅할 때마다 권한을 다시 부여하는 설정이 필요하다.

① Tailscale 패키지 버전이 1.22 이상인지 확인

② DSM 제어판 > 작업 스케줄러 > 트리거 된 작업 > [사용자 정의 스크립트] 클릭

③ [일반] 탭 > [작업] 필드에 원하는 이름 입력, [사용자]는 root 선택

④ [작업 설정] 탭 > [사용자 정의 스크립트] 필드에 아래 명령어 입력

/var/packages/Tailscale/target/bin/tailscale configure-host; synosystemctl restart pkgctl-Tailscale.service

Tailscale 업데이트 + TUN 활성 스크립트

Tailscale 패키지를 업데이트하면 TUN 설정도 함께 초기화된다. 업데이트할 때마다 매번 TUN을 수동으로 활성화하기 번거롭기 때문에 패키지 업데이트와 TUN 활성화를 함께 처리하는 스크립트를 만들어 두고 스케줄러에 등록하면 더 편리하다.

① 나스 SSH 접속 (접속 방법은 가이드 링크 참고)

# 나스 SSH 접속 명령어 형식
# 예: myuser@192.168.1.50 -p 2222
ssh [사용자명]@[호스트 주소] -p [포트 번호]

② 관리자 권한 획득

# 명령어를 입력하면 DSM 비밀번호를 물어보는 프롬프트가 나온다
sudo -i

③ ~/.scripts 폴더에 update_tailscale.sh 파일 생성 후 편집기 열기

# 파일 생성 후 편집기를 여는 명령어
mkdir -p ~/.scripts && vi ~/.scripts/update_tailscale.sh

④ i 눌러서 편집 모드로 진입 → 아래 내용 복사/붙여 넣기 → ESC 누른 후 :wq 입력해서 저장/편집기 종료

#!/bin/sh

# Tailscale 실행 파일의 전체 경로를 변수로 지정
TAILSCALE_BIN="/var/packages/Tailscale/target/bin/tailscale"

# 업데이트 전 Tailscale 버전 확인
version_before=$($TAILSCALE_BIN version | head -n 1)

# 업데이트 시도 (--yes 플래그로 자동 동의)
$TAILSCALE_BIN update --yes

# 업데이트 후 Tailscale 버전 다시 확인
version_after=$($TAILSCALE_BIN version | head -n 1)

# 두 버전이 다른지 비교
if [ "$version_before" != "$version_after" ]; then
  # 버전이 다르다면, 업데이트가 성공한 것이므로 후속 명령어 실행
  echo "Tailscale이 $version_before 에서 $version_after 버전으로 업데이트되었습니다."
  echo "TUN 활성화를 실행합니다..."

  $TAILSCALE_BIN configure-host
  synosystemctl restart pkgctl-Tailscale.service

  echo "작업이 완료되었습니다."

fi

⑤ 생성한 스크립트 파일에 실행 권한 추가

# 실행 권한 추가 명령어
chmod +x /root/.scripts/update_tailscale.sh

⑥ /root/.scripts/update_tailscale.sh 명령어 입력해서 스크립트 실행 테스트

# 로그 출력 예시
already running stable version 1.86.2; no update needed

⑦ TUN 활성 스케줄러의 [사용자 정의 스크립트] 경로 변경

/root/.scripts/update_tailscale.sh

레퍼런스

Access Synology NAS from anywhere · Tailscale Docs

Install Tailscale on your Synology device. Use this guide to get secure access to your Synology NAS from anywhere.

tailscale.com

작은 크기의 소음없는 최고의 가성비 UPS - WalleCube

ColorFilter — Wed, 30 Jul 2025 06:55:43 +0900

24시간 내내 작동하는 나스(NAS)에 중요한 자료를 저장해 두고 사용한다면, 예기치 못한 정전이나 불안정한 전력 상황으로부터 데이터를 보호하기 위해 UPS 사용을 적극 권장한다. UPS(Uninterruptible Power Supply, 무정전 전원 공급장치)는 내부에 배터리를 탑재하여 비상 전원을 공급해 주는 장치다. 일종의 외장 배터리라고 보면 된다.

UPS는 단순히 전원을 유지하는 데 그치지 않고, NAS가 시스템을 안전하게 종료할 수 있도록 시간적 여유를 제공한다는 장점이 있다. NAS를 UPS에 연결해 두면 정전이 발생했을 때 모든 작업을 마친 뒤 자동으로 전원을 종료하도록 설정할 수 있다.

하드디스크는 고속으로 회전하는 플래터 위를 미세한 간격으로 헤드가 움직이는 정밀한 기계장치로, 갑작스러운 전원 차단에 매우 취약하다. UPS 없이 전원이 꺼지면 데이터 기록 중 헤드가 플래터에 충돌하거나 파일 시스템이 손상되어 데이터를 영구적으로 잃을 수 있다. UPS는 단순한 주변기기가 아닌, 데이터를 지키기 위한 필수적인 안전장치라고 볼 수 있다.

UPS는 용량, 배터리 종류, 브랜드, 기능에 따라 가격이 천차만별이다. 일반적으로 보급형 7~15만 원, 중급형 15만 원~30만 원, 고급형 30만 원 이상으로 형성되어 있으며, 대표적인 브랜드로 델타(Delta), 이튼(Eaton), APC 등이 있다. 가정용으로 사용할 경우 보급형으로도 충분하지만 대부분 납축(Lead-Acid) 배터리를 사용하기 때문에 충격에 약하고 폭발 위험이 있으며 수명도 300~500회 충방전으로 짧은 편이다. 반면 리튬인산철(LFP) 배터리는 2,000회 이상 충방전이 가능하고 납축 배터리보다 가벼우면서 부피 또한 작다. 아쉽게도 리튬인산철은 대부분 중·고급형 모델에서만 사용한다.

몇 달 전 우연히 WalleCube(瓦力盒子)라는 중국의 가성비 좋은 UPS 제품을 영입하여 매우 만족스럽게 사용하고 있다. 이번 포스팅에는 이 제품의 주요 특징과 설정 방법을 소개해 보려고 한다. 작은 크기, 무소음, 리튬인산철 배터리, 전력 대시보드 및 알림 지원(via 위챗), WOL 지원(Wake-on-LAN), 5만 원대 저렴한 가격 등 장점이 정말 많은 제품이다. 중국 내 커뮤니티에서도 좋은 평가를 받고 있다. 중국어에 대한 거부감이 없거나 중국어가 가능하다면 강력 추천한다.

시놀로지 나스 DS218+ 위에 올려둔 WalleCube W120 UPS. 아담한 사이즈로 부담없이 배치할 수 있다.

제품 스펙

WalleCube W120 UPS 외관. 이미지 출처 WalleCube

내가 사용 중인 Synology DS218+ 모델은 공식적으로 액세스(데이터 읽기/쓰기) 상태일 때 17.23W, 절전 모드일 때 5.4W 전력 소비량을 가진다. W120 UPS는 액세스 상태를 기준으로 약 3시간 정도 사용할 수 있는 넉넉한 배터리 용량을 제공한다.

모델명: W120 (다음 모델인 W150 나온 상태)
전압: 9V-20V
전류: 2A-10A
최대 출력: 120W
대기 전력: 0.6W
배터리 용량: 57.6Wh (12V 기준 약 4800mAh)
배터리 유형: 리튬 인산철 (2000회 이상 충방전)
작동 온도: 0-40℃
디스플레이: 1.47인치 TFT
크기: 120x104x40 (mm)
중량: 722g
인터넷 연결 방식: 2.4G 와이파이
네트워크 설정 방식: 블루투스
지원 NAS 브랜드: 시놀로지, 유그린, 테라마스터, QNAP 등

주요 특징

WalleCube UPS 위챗 대시보드

기존 어댑터에 연결해서 사용
무소음 작동 (팬리스 설계)
배터리 전환 지연 시간 5ms (W150 모델은 1ms)
전력 대시보드 (위챗)
WOL 지원 (위챗)
배터리 모드 진입 알림 (위챗)
배터리 온도 모니터링 (W150 모델)
배터리 헬스 체크 (W150 모델)

커넥터 연결

DC5521 키트 연결 방법. 이미지 출처 WalleCube

WalleCube는 기존 어댑터를 이용해 전원을 공급하기 때문에 사용 중인 NAS 모델에 맞는 옵션을 선택해야 한다. 나는 시놀로지 DS218+ 제품을 사용하고 있어서 DC5521 키트 옵션으로 구매했다. DC5521 키트는 UPS 본체, USB 케이블, 커넥터 2개로 구성돼 있으며 아래 순서로 연결한다.

기존 사용하고 있는 나스 어댑터에 DC5521 Female to DC5525 Male 커넥터 연결
UPS 본체에 DC5521 Female to DC5525 Male 커넥터 연결
UPS ⇄ NAS에 DC5525 Male to DC5521 Male 커넥터 연결
UPS ⇄ NAS에 USB 케이블 연결

참고로 시놀로지 DS4xx, DS7xx, DS9xx 시리즈는 4핀 커넥터 키트로 구매해야 한다.

기기 연동

UPS 전원 켜고 화면 켜질 때까지 대기
UPS 전원 버튼 3초 누르면 QR 코드 표시
위챗 WalleCube 미니앱(瓦力电源小程序) 회원가입/로그인
우측 상단 ⊕ 버튼(위 이미지 ❶번) → UPS 화면상에 표시된 QR 스캔해서 기기 연동
블루투스 연결 (위 이미지 ❷번 连接蓝牙 버튼)
2.4G 와이파이 연결 (위 이미지 ❸번 设置WiFi 버튼)

나스 설정 (시놀로지 기준)

DSM > 제어판 > 하드웨어 및 전원 > 일반 탭

[전원 공급 문제가 해결되면 자동으로 다시 시작]은 UPS가 배터리 모드에서 AC 모드로 전환될 때 NAS가 자동으로 켜지도록 하는 기능이다. [LAN에서 WOL 활성화]는 네트워크를 통해 원격으로 NAS를 켤 수 있는 기능이다. 이 두 옵션을 모두 활성화하면, 정전 후 전원이 복구될 때 NAS가 자동으로 부팅되고, 필요할 때마다 원격으로 시스템을 시작할 수 있다.

제어판 → 하드웨어 및 전원 → 일반 탭

DSM > 제어판 > 하드웨어 및 전원 > UPS 탭

[시간 사용자 지정]은 정전 발생 시 설정한 시간만큼 기다린 후 시스템을 대기 모드로 전환시키는 기능이다. 일반적으로 5~10분 사이로 설정하는 것을 권장한다. 예를 들어 5분으로 설정하면 정전 발생 5분 후 NAS가 대기 모드로 진입한다. UPS 배터리 잔량이 매우 낮을 경우 설정한 시간과 관계없이 즉시 대기 모드로 전환될 수 있다.

제어판 → 하드웨어 및 전원 → UPS 탭

참고로 [네트워크 UPS 서버 활성화]는 하나의 UPS로 여러 대의 시놀로지 NAS 전원을 관리하는 기능이다. UPS에 직접 연결된 NAS 한 대를 '서버'로 지정하면, 같은 네트워크에 있는 다른 NAS들이 이 서버로부터 UPS 상태 정보를 받아 정전 시 안전하게 종료 절차를 수행할 수 있다.

전원 어댑터 설정 ⚡️

먼저 UPS에 연결한 어댑터의 정격 출력을 확인해야 한다. 보통 OUTPUT이라고 적혀 있는 부분에 전압(V)과 전류(A)가 표기되어 있다. 나는 12V 5A로 총 60W(12V×5A) 출력을 지원하는 어댑터를 사용하고 있다.

전압 12V 전류 5A 어댑터 참고용 이미지 via 이베이

어댑터의 출력을 확인했다면, 위챗 WalleCube 미니앱 > 连接蓝牙 버튼을 눌러 블루투스에 연결한다. 연결이 완료되면 高级配置(고급 설정) > 电源适配器设置(전원 어댑터 설정) 페이지로 이동하여 전압과 전류를 각각 입력해 준다. 잘못 입력하면 UPS가 충전되지 않거나 NAS에 손상을 줄 수 있으므로 주의하자.

电源适配器电压: 전원 어댑터 전압(V)
电源适配器电流: 전원 어댑터 전류(A)
断电判断电压: 정전 여부 판단 전압(A). 입력한 전압보다 낮아지면 정전으로 간주하고 배터리 모드로 전환된다. 전압값 변경 시 자동으로 입력되며, 전압의 90% 수준으로 설정하는 걸 권장한다.

무출력 절전 시간 설정

위챗 WalleCube 미니앱 > 高级配置(고급 설정) > 无输出休眠时间配置(무출력 절전 시간 설정) 페이지에서 무출력 절전 시간과 임계 전류를 설정할 수 있다. 기본값으로 두고 사용해도 무방하지만, NAS 외에 다른 기기도 UPS에 연결하여 사용한다면 설정값을 적절하게 조절해 주는 것이 좋다.

无输出休眠时间 무출력 절전 시간

⚙️ 기본값 300(초) | 설정 범위 31~3600(초)

UPS 출력 전류가 일정 기준(기본값 150 mA) 미만인 상태로 설정한 시간 동안 지속되면, UPS는 출력을 멈추고 절전 모드로 전환된다. 이후 전력이 복구되면 UPS가 다시 켜져서 NAS에 전원을 공급하고, WOL 설정을 해뒀다면 NAS도 자동으로 부팅된다. 일반적인 정전 시나리오는 다음과 같다.

정전 발생 → UPS 배터리로 NAS에 전원 공급
NAS 설정에 의해 일정 시간 이후 자동 종료(대기 모드)
UPS 출력 전류가 임계값 미만으로 감소
설정한 시간 동안 출력 전류가 낮은 상태로 유지되면 UPS가 절전 모드로 진입
이후 다시 전기 공급되면 UPS 켜짐 → NAS에 전원 공급 → NAS 자동 재시작

无输出休眠最大电流 무출력 절전 임계 전류

⚙️ 기본값 150(mA) | 설정 범위 50~1000(mA)

UPS 출력이 설정한 전류값 이상이면 절전 모드로 전환되지 않는다. NAS 외에 공유기 같은 다른 장치를 함께 연결한 경우, 정전 시 NAS는 종료되더라도 다른 장치의 출력 전류로 인해 UPS가 절전 모드에 진입하지 못한다. 이럴 때는 NAS를 제외한 다른 장치들의 소비 전력보다 임계값을 높게 설정해 두면 문제를 해결할 수 있다. UPS가 절전 모드로 전환되지 못하는 시나리오는 다음과 같다.

NAS와 공유기를 UPS에 함께 연결해서 사용
정전 발생 → NAS는 자동 종료되지만, 공유기는 계속 켜진 상태
공유기 소비 전력 때문에 총 출력 전류가 임계값(150mA) 이하로 감소하지 않음
UPS가 절전 모드로 진입하지 못해서 배터리 소진 후 종료

150 mA(밀리암페어)는 0.15A(암페어), 전압이 12V라면 0.15A × 12V = 1.8W

화면 절전 시간 설정

UPS 본체의 화면은 기본적으로 5분(300초) 후에 꺼진다. 위챗 WalleCube 미니앱 > 高级配置(고급 설정) > 屏幕休眠时间(화면 절전 시간) 설정 페이지에서 30~36000초 사이의 화면 꺼짐 시간을 조정할 수 있다.

WOL 기능 활성

나스가 WOL 기능을 지원하고 UPS와 동일한 네트워크에 연결돼 있다면 원격으로 나스를 켤 수 있다. UPS 대시보드에서 자동 부팅(自动开机)으로 설정해 두면, 정전 후 전원이 복구될 때 UPS가 지정한 MAC 주소로 WOL 신호를 전송한다. 다만 WOL은 신호 수신 여부를 확인하지 않는 단방향 명령(UDP)이므로 부팅 성공을 100% 보장하지는 않는다. NAS가 켜지지 않을 경우 수동 부팅(手动开机)으로 여러 차례 다시 시도해 보자.

시놀로지 나스 제어판 > 정보 센터 > 네트워크 탭 > MAC 주소를 복사한 후, 위챗 WalleCube 미니앱 > 远程开机(원격 부팅) > 自动开机(자동 부팅) 탭에서 복사한 MAC 주소를 붙여넣으면 설정이 완료된다.

시놀로지 나스 MAC 주소 복사

복사한 MAC 주소를 UPS 위챗 대시보드에 등록

다중 장치 연결

UPS 입력 단자에는 전원 공급용 어댑터 하나만 연결할 수 있지만, 출력 단자를 통해 전압이 동일한 기기(공유기, NAS 등)를 여러 대 연결하여 동시에 전원을 공급할 수 있다.

UPS에서 사용하는 어댑터와 전압이 같다면 공유기 등 다른 기기를 UPS에 연결해서 함께 사용할 수 있다(UPS에 연결할 커넥터가 필요할 수 있음). 이때 UPS 어댑터의 출력은 연결하려는 모든 장치의 원래 어댑터 출력의 합보다 커야 한다. ⚠️ 전압이 다르면 어떤 경우에도 함께 사용할 수 없으므로 주의하자.

현재 사용 중인 나스 어댑터 전압은 12V인 반면 공유기 어댑터 전압은 19V여서 공유기는 UPS에 연결해서 사용할 수 없다

예를 들어 나스 전류가 5A, 공유기 전류가 2A라면 어댑터는 최소 7A 이상의 전류를 공급할 수 있어야 한다. 전압이 12V이면 최대 출력은 7A × 12 = 84W이므로, UPS의 최대 출력(120W)보다 작아서 여유롭게 사용할 수 있다.

위챗 알림 설정

UPS가 위챗 WalleCube 미니앱에 연동된 상태에서, WalleCube 위챗 공식 계정(瓦力电源公众号)을 팔로우하면 배터리/AC 모드 전환, 전력 사용량, UPS 오프라인 상태에 대한 실시간 알림을 받을 수 있다. 알림은 WalleCube 공식 계정을 통해 전달된다.

배터리 모드 전환 실시간 알림 예시. 중국어만 지원한다.

위챗 WalleCube 미니앱 > 消息通知(메시지 알림) 페이지에서 세부적인 알림을 설정할 수도 있다.

断电消息微信推送: 배터리 모드 전환 시(정전 발생) 위챗 공식 계정을 통해 알림
电量使用微信推送: UPS 전력 사용량 알림 (매일 혹은 매주)
离线推送间隔时间: UPS가 오프라인 상태일 때 알림 반복 전송 간격(30분 단위로 설정 가능)

제품 분해 사진

WalleCube UPS는 인버터를 사용하지 않은 DC 출력 회로를 통해 빠른 전환 속도, 작은 크기, 무소음을 구현한 특징을 가진다. 내부적으론 XHSC(小华半导体)의 HC32L072JATA MCU(마이크로컨트롤러)가 전반적인 시스템 제어를 담당하고, SouthChip(南芯科技)의 SC8812A 칩이 배터리 충·방전을 관리한다. 발열 해소를 위한 서멀 패드와 온도 감지 센서 등 안전장치도 충실하게 갖추고 있다. 배터리 셀은 SunPower(长虹三杰) 26700 리튬인산철(LiFePO₄) 전지를 사용하고 있다.

더욱 상세한 제품 분해 리뷰는 EDN China(电子技术设计)에서 확인할 수 있다. PCB 구성, 핵심 부품, 슬라이싱 구조, 방열 설계 등 제품 내부의 디테일한 정보가 포함되어 있다.

본체 화면을 통해 출력 전압/전류, 배터리 잔량, 남은 사용 시간 및 연결 상태가 표시된다

본체 뒷면에는 전원 입력, 전원 출력, USB 포트가 장착되어 있다

UN38.3 국제 운송 안전 표준 통과 마크

한 손에 들어오는 작은 크기와 알루미늄 합금 케이스 덕분에 디자인이 깔끔해보인다

배터리는 플라스틱 브래킷으로 절연 고정되어 있다

SunPower 리튬 인산철 배터리. 정격 전압 3.2V, 용량 4500mAH, 에너지 14.4Wh

RISC-V 32비트 싱글 코어 프로세서가 내장된 저전력 SoC 무선 연결 칩

화면 케이블 커넥터

XHSC의 MCU(마이크로컨트롤러 유닛)

홍콩 스테이블코인 발행과 디지털 금융 경쟁 구도

ColorFilter — Thu, 24 Jul 2025 00:09:58 +0900

Photo by Ruslan Bardash

지난 5월 홍콩이 「스테이블코인 조례」를 통과시키면서, 오는 8월 1일부터 기업들이 라이선스를 신청하고 스테이블코인을 발행할 수 있게 되었다. 홍콩에서 스테이블코인을 도입하면 모두에게 새로운 금융 수단과 기회가 생기게 된다. 오늘은 홍콩 스테이블코인 발행이 갖는 중요한 의미를 설명해 볼까 한다.

스테이블코인이란?

스테이블코인은 암호화폐의 한 종류로, 비트코인이 가진 가격 불안을 해소하기 위해 등장했다. 비트코인은 최초의 암호화폐지만 가격 변동이 매우 심하다. 오늘 햄버거 8개 가치였던 것이 내일은 5개가 되고 모레는 다시 7개로 변할 수 있다. 이 때문에 비트코인은 실제 거래 수단으로는 부적합하여 다른 물건을 구매할 때 사용하기 어렵다.

그래서 사람들은 가격이 안정적인 암호화폐인 스테이블코인을 만들었다. 가장 대표적인 스테이블코인인 USDT는 2014년 테더(Tether)사가 발행하기 시작했다. 참고로 비트코인은 2009년에 탄생했다.

Tether는 밧줄이나 끈처럼 무언가를 묶거나 고정하는 데 쓰이는 줄을 뜻한다. Photo by Thomas Couillard

테더는 USDT의 가격이 항상 1달러로 유지된다고 약속한다. 1달러를 테더사에 주면 USDT 1개를 얻을 수 있고(실물이 아닌 블록체인 장부에 기록), 필요하지 않으면 다시 테더사에 팔아서 1달러를 돌려받을 수 있다.

이론적으로 테더가 항상 충분한 달러 준비금을 보유하고 있는 한, 스테이블코인과 달러의 교환 비율은 1:1로 유지될 수 있다. 테더는 준비금 현황 보고서를 정기적으로 공개하고 있으며, 예치된 달러 자산의 대부분을 미국 국채 매입 등에 사용하고 있다.

사람들이 스테이블코인을 달러와 동일한 가치로 인정하기 시작하면, 달러를 사용할 수 있는 곳 어디서나 스테이블코인을 사용할 수 있게 되어 다양한 상품을 구매할 수 있다.

현재 USDT는 세계에서 거래량이 가장 많은 암호화폐로 비트코인을 넘어섰다. 대부분의 경우 다른 암호화폐 거래에 사용된다.

미국의 규제 움직임

사람들은 스테이블코인을 사용하면서 미국 정부의 규제를 피할 수 있다는 사실을 발견했다. 스테이블코인 거래는 은행 시스템과 완전히 분리되어 있으며, 익명 지갑 간의 거래이므로 추적이나 규제가 거의 불가능하다.

예를 들어, 미국 정부가 어느 날 갑자기 A라는 사람의 달러 사용 금지 명령을 내렸다고 가정해 보자. 이 경우 A는 스테이블코인을 사용하여 B로부터 원하는 물건을 구매하고, B는 그 스테이블코인을 다시 달러로 환전하면 된다.

물론 블록체인의 모든 거래는 원칙적으로 추적이 가능하고, 미국 정부가 제재 대상과 연관된 암호화폐 지갑 주소를 차단하거나 발행사에 요청하여 자금을 동결시키기도 한다. 하지만 수많은 지갑이 익명으로 생성되고 믹서(Mixer) 같은 서비스로 출처를 흐릴 수 있어 완벽한 추적은 여전히 어려운 과제로 남아 있다.

미국 역시 이 문제를 인식하고, 스테이블코인에 대한 포괄적 규제 프레임워크인 지니어스 법안(GENIUS Act)이 최근 법률로 제정됐다. 법안의 주요 골자는 다음과 같다.

스테이블코인 발행 기관은 미국 관할 지역 내에 있어야 하며, 정부 허가를 받아야 한다.
발행기관은 예치된 달러를 1:1 비율로 미국 예금/단기 국채 등으로 보유해야 한다.
미국 규제를 충족하지 않는 스테이블코인은 미국 내 유통이 차단·동결될 수 있다.

홍콩의 절묘한 한 수

홍콩 정부가 제정한 「스테이블코인 조례」는 디지털 자산 허브의 주도권을 잡기 위한 전략적 묘수로 평가된다. 이 제도는 라이선스를 취득한 기관이 홍콩 달러 기반의 스테이블코인을 발행할 수 있도록 허용한다.

7.8 홍콩 달러(HKD)는 1 미국 달러(USD)로 고정되어(페깅) 있기 때문에 홍콩 달러 기반 스테이블코인과 미국 달러 기반 스테이블코인의 환율도 동일하게 고정된다(물론 시장 상황과 수수료 등에 따라 유동적으로 변할 수 있다).

페깅(Pegging): 특정 자산의 가치를 다른 자산에 고정시키는 것.

홍콩 달러 스테이블코인은 미국 달러 스테이블코인과 공존하며 새로운 경쟁 구도를 형성할 것으로 보인다. 특히 아시아 시장을 중심으로 국경 간 결제를 혁신하고, 디지털 자산 시장에서 일부 기축 통화 역할을 수행하며 영향력을 확대해 나갈 것으로 전망된다.

주목할 점은 홍콩 달러 스테이블코인이 홍콩 금융관리국의 독자적인 규제 아래 발행된다는 점이다. 이는 미국의 직접적인 규제에서 벗어나 있지만, 홍콩 달러 자체가 미국 달러에 연동되어 있어 미국 통화 정책의 간접적인 영향을 받는 양면성을 지닌다.

즉, 홍콩은 달러 가치와 연동되면서도 미국의 규제를 피할 수 있는 금융 수단을 만들어낸 셈이다. 만약 특정 상황의 국제 무역에서 달러 결제가 불가능해진다면, 홍콩 달러 스테이블코인을 결제 수단으로 사용할 수 있을지도 모른다.

위안화 스테이블코인의 가능성

위안화에 연동된 스테이블코인이 등장할 수 있을까? 현재로서는 그럴 가능성은 낮아 보인다. 스테이블코인은 익명성을 바탕으로 자유로운 교환 및 국경 간 이동이라는 속성을 지녔다. 만약 위안화 기반 스테이블코인이 발행된다면, 자본 유출 통로로 악용될 수 있어 중국 정부의 통제 정책과 정면으로 배치된다.

[JS] 두 점 사이의 거리 계산하기

ColorFilter — Sun, 20 Jul 2025 00:23:07 +0900

요소 내부의 고정된 지점과 마우스 클릭 지점 사이의 거리를 계산해야 하는 경우가 종종 있다. 예를 들어 사용자 경험(UX) 개선을 위해 버튼 클릭 감지 영역을 실제보다 더 넓게 설정할 때(클릭하기 쉽도록 하기 위해) 이런 계산이 필요하다.

이때 두 지점 간의 거리는 피타고라스 정리를 이용해서 구할 수 있다. 피타고라스 정리는 직각삼각형에서 빗변(가장 긴 변)의 제곱은 다른 두 변의 제곱의 합과 같다는 원리다.

$$c^2 = a^2 + b^2$$

빗변 $c$의 길이를 구하기 위해 양변에 제곱근(루트; square root)을 적용하여 다음과 같이 표현할 수도 있다.

$$c = \sqrt{a^2+b^2}$$

한편, 피타고라스의 원리를 적용하기 위해 좌표평면(서로 수직으로 교차하는 두 직선으로 이루어진 평면)에서 두 점을 기준으로 가상의 직각삼각형을 만들 수 있다. 고정된 지점 $(x_1,y_1)$과 마우스 클릭 지점 $(x_2,y_2)$은 직각삼각형의 빗변을 이루고, 나머지 가상의 꼭짓점은 $(x_2,y_1)$ 또는 $(x_1,y_2)$ 좌표에 위치하게 된다.

위 원리를 이용하면 마우스 클릭 지점과 특정 지점 사이의 거리가 허용 범위 안에 들어오는지 확인하는 함수를 만들 수 있다. 특정 요소의 원점(0, 0)을 기준으로 클릭 지점의 좌표 계산하는 방법은 이전 포스팅 참고.

const isColliding = (point: Point, mouse: Point): boolean => {
  // 피타고라스 정리를 이용해 point와 mouse 사이의 거리(빗변) 계산
  // mouse.x 또는 mouse.y는 요소를 기준으로 한 좌표 (e.clientX/Y - rect.left/top)
  const dx = point.x - mouse.x;
  const dy = point.y - mouse.y;
  const distance = Math.sqrt(dx ** 2 + dy ** 2);
  // 클릭 판정 영역을 넓게 설정하여 선택하기 쉽도록 조정
  return distance < STYLE.BASE_POINT_RADIUS * 2.5;
};

AdGuard 사용 시 티스토리 gif 이미지 안나오는 문제 해결

ColorFilter — Mon, 7 Jul 2025 21:05:09 +0900

문제 파악

얼마 전부터 티스토리 블로그에 .gif 파일을 올려도 이미지가 보이지 않는 문제가 발생했다. 포스트를 발행하고 내용을 확인해 보면 아래 스크린샷처럼 이미지 캡션(설명)만 보이고 정작 이미지는 나오지 않고 있었다.

원인을 파악하기 위해 크롬 개발자 도구로 HTML 코드를 살펴보니, 업로드한 원본 파일명과 관계없이 실제 이미지를 불러오는 주소는 아래처럼 항상 img.gif 라는 파일명을 가진 임시 URL을 통해 리소스를 요청하고 있었다.

https://blog.kakaocdn.net/dna/.../img.gif?credential=...

카카오 CDN(콘텐츠 전송 네트워크)에 원본 파일을 저장하되, 보안을 위해 일정 시간만 유효한 임시 주소(Pre-signed URL)를 발급하는 방식으로 보였다. 이 임시 URL 주소를 복사한 후 브라우저에서 직접 열어보니 이미지는 정상적으로 표시됐다.

혹시 AdGuard 필터 때문에 발생한 문제인가 싶어서 필터링 로그를 확인해 보니... 역시나 AdGuard 추적 보호(Tracking Protection) 필터에 포함된 /img.gif? 규칙이 카카오 CDN의 임시 URL을 광고로 오인하여 차단하고 있었다.

해결 방법

해결 방법은 간단하다. AdGuard 설정 > 필터 구독 > User rules 항목에서 아래 규칙을 추가해 주면 된다. 모바일에선 보호(하단 방패 아이콘) > Safari 보호(iOS 기준) > 사용자 규칙에서 추가할 수 있다.

@@||blog.kakaocdn.net*/img.gif

규칙을 추가한 뒤 브라우저를 새로고침하거나 재실행하면, 차단되었던 .gif 이미지가 모두 정상적으로 표시되는 걸 확인할 수 있다.

[CS] 베지에 곡선 원리 이해하기 feat. 카스텔조 알고리즘

ColorFilter — Mon, 23 Jun 2025 01:39:22 +0900

CSS에서 애니메이션이나 전환 효과를 제어할 때 타이밍 함수(가속도 곡선)를 사용한다. 타이밍 함수는 애니메이션이 얼마나 빠르게 또는 느리게 시작하고 끝나는지를 결정하는 수학적인 함수다. 쉽게 말해 애니메이션의 속도 변화를 제어하는 역할을 한다.

Tailwind CSS를 사용한다면 ease-in, ease-out, ease-in-out 등 미리 정의되어 있는 유틸리티 클래스를 사용해서 다양한 가속도 곡선을 적용할 수 있다.

<!-- 
transition-timing-function: cubic-bezier(0.4, 0, 1, 1); 
transition-duration: 300ms;
-->
<button class="ease-in duration-300 ...">Button A</button>

예를 들어 ease는 부드럽게 시작해서 부드럽게 끝나고(일반적인 가속도 곡선), ease-in은 느리게 시작해서 빠르게 끝나는 효과를 줄 때 사용한다.

사실 ease, ease-in, ease-out, ease-in-out 등은 CSS에서 기본적으로 제공하는 타이밍 함수(easing function) 프리셋이다. 각 값은 아래처럼 cubic-bezier 곡선으로 미리 정의되어 있다.

ease           /* cubic-bezier(0.25, 0.1, 0.25, 1) */
ease-in        /* cubic-bezier(0.42, 0, 1, 1) */
ease-out       /* cubic-bezier(0, 0, 0.58, 1) */
ease-in-out    /* cubic-bezier(0.42, 0, 0.58, 1) */
...

베지에 곡선은 컴퓨터 그래픽스에서 부드러운 곡선을 표현하기 위해 사용하는 수학적 곡선으로, 조절점(control point)이라고 부르는 점들의 집합으로 정의된다. n개의 조절점이 주어지면 n-1차 베지에 곡선을 만들 수 있다.

왼쪽부터 1차(조절점 2개), 2차(조절점 3개), 3차(조절점 4개) 베지에 곡선. Image via JavaScript Info

CSS에서 사용하는 cubic-bezier() 함수는 4개의 조절점(P₀, P₁, P₂, P₃)으로 구성된 3차 베지에 곡선을 기반으로 한다. 이 중 시작점(P₀)과 끝점(P₃)은 항상 (0, 0)과 (1, 1)로 고정되어 있다. 따라서 실제로는 중간에 있는 두 제어점(P₁, P₂)만 직접 설정한다.

/* cubic-bezier(P1.x, P1.y, P2.x, P2.y) 형태로 사용 */
transition: width 1s cubic-bezier(0.12, 0.83, 0.92, 1);

/* x 좌표(지속시간)는 반드시 [0, 1] 범위 내에 있어야 함 */
cubic-bezier(0.25, 0.1, 0.75, 1.0) /* ✅ */
cubic-bezier(1.5, 0.1, 0.75, 1.0)  /* ❌ */

/* y 좌표(진행률)는 [0, 1] 범위를 벗어날 수 있으며, 범위를 벗어나면 바운싱 효과 생성 */
cubic-bezier(0.1, -0.6, 0.2, 2.0)

한편, 베지에 곡선은 카스텔조 알고리즘을 통해 만들 수 있다. 주어진 조절점을 선분(시작점과 끝점이 정해진 직선)으로 연결한 후, 각 선분을 동일한 비율 t로 내분(선분을 주어진 비율로 나눔; 선형 보간)하여 새로운 점들을 구하는 과정을 기반으로 한다. 두 점 사이의 선분을 특정 비율 t로 나누는 연산은 내분 혹은 선형 보간이라고 부른다.

점의 개수가 1개만 남을 때까지 선형 보간을 반복하면, 최종적으로 남은 점이 베지어 곡선 위의 좌표가 된다. 즉, 카스텔조 알고리즘은 선형 보간을 재귀적으로 적용하여 곡선의 점을 계산하는 방식이다.

글만 보면 이해하기 어려울 수도 있으니 2차 베지에 곡선부터 하나하나 만들어 보자.

보간 (插值, Interpolation)

보간은 이미 알고 있는 여러 지점을 기반으로, 그 사이의 알려지지 않은 값을 추론하는 모든 과정을 가리킨다. 한자 뜻 그대로 사이(間)를 보충(補)한다는 의미. 예를 들어 $x=0$일 때 값이 $0$이고 $x=10$일 때 값이 $100$이라면, 그 사이인 $x=3$이나 $x=7$의 값을 추정하는 과정이 바로 보간이다.

선형 보간 (线性插值, Linear Interpolation)

선형 보간은 이러한 보간 기법 중 가장 대표적이고 간단한 방법. 선형 보간은 알려진 두 점을 직선으로 잇는다고 가정하고, 그 직선 위의 중간 값을 계산하는 방식이다. 줄여서 Lerp라고도 부른다. 참고로 선형은 직선 형태를 가리킨다.

2차 베지에 곡선

먼저 A, B, C 조절점 3개를 직선으로 잇는다. 그럼 AB, BC 두 개의 선분이 생긴다.

각 선분을 동일한 비율 t(0 ≤ t ≤ 1)로 나눈다(내분). 예를 들어 t가 0.3이라면 A에서 B 방향으로 30% 이동한 지점 D와, B에서 C 방향으로 30% 이동한 지점 E가 만들어진다.

점 D와 E를 다시 직선으로 이어 새로운 선분 DE를 만든다.

이 선분에서 다시 t만큼 이동한 지점 F를 구한다. 점이 F 하나만 남았으므로 이 지점이 베지에 곡선의 좌표가 된다.

t 값을 0부터 1까지 조금씩 증가시키며(0.05, 0.1, …, 0.95, 1) 위 과정을 반복하면, 여러 개의 점이 생성되고, 이 점들을 순서대로 이으면 2차 베지에 곡선이 완성된다.

아래 코드펜에서 Start Animation 버튼을 클릭하면 곡선이 그려지는 과정을 직접 확인해 볼 수 있다.

3차 베지에 곡선

3차 베지에 곡선은 조절점 4개로 이루어진다. 곡선을 만드는 기본 원리는 2차 베지에 곡선과 동일하지만, 조절점이 하나 늘어났기 때문에 선형 보간 과정이 한 번 더 반복된다.

먼저 A, B, C, D 조절점 4개를 직선으로 잇는다.

AB, BC, CD 각 선분을 동일한 비율 t로 내분한다.

내분하여 생긴 점 E, F, G를 이어 새로운 선분 EF, FG을 만든다.

새로운 선분을 다시 t로 내분하여 점 H, I를 만든다.

내분하여 생긴 점을 직선으로 이어 선분 HI를 만든다.

선분을 다시 t만큼 내분하여 점 J를 구한다. 점이 1개만 남았으므로 이 지점이 베지어 곡선의 좌표가 된다.

3차 베지에 곡선이 만들어지는 자세한 과정은 아래 코드펜을 참고하자.

베지에 곡선 수학 공식 이해하기

1차 베지에 곡선 (조절점 2개)

1차 베지에 곡선(조절점 2개)은 아래 수학 공식으로 표현할 수 있다. — 선형 보간 공식

$$ P = (1-t)P_1 + tP_2 $$

$P_1$은 시작점, $P_2$는 끝점, $t$는 진행률(0 이상 1 이하, 0이면 출발 1이면 도착), $P$는 $t$에 따라 $P_1$에서 $P_2$로 이동한 위치(진행률)를 나타낸다.

예를 들어 $t = 0$일 때 $P$는 $P_1$과 정확히 일치한다.

$$ \begin{aligned} t &= 0 \\ P &= (1 - 0)P_1 + 0 \cdot P_2 \\ &= 1 \cdot P_1 + 0 \\ &= P_1 \end{aligned} $$

$t = 0.3$은 출발점 $P_1$에서 끝점 $P_2$ 방향으로 전체 거리의 30%만큼 이동한 지점을 의미한다. 이 지점의 위치 $P$는 $P_1$과 $P_2$ 위치에 각각 가중치를 곱하여 더하는 가중 평균(weighted average) 방식으로 계산할 수 있다. 가중 평균은 위치가 더 가까운 지점에 더 큰 가중치를 부여한다. $t = 0.3$ 일 때 $P$는 $P_1$에서 30%만큼 떨어져 있고, $P_2$에 70%만큼 떨어져 있으므로 $P_1$에 더 가깝다. 따라서 $P_1$에 가중치를 70%, $P_2$에 가중치 30%를 적용하여 결과적으로 $P = 0.7 \cdot P_1 + 0.3 \cdot P_2$ 수식이 완성된다.

$$ \begin{aligned} t &= 0.3 \\ P &= (1 - 0.3)P_1 + 0.3 \cdot P_2 \\ &= 0.7 \cdot P_1 + 0.3 \cdot P_2 \end{aligned} $$

$t = 1$일 때 $P$는 $P_2$와 정확히 일치한다.

$$ \begin{aligned} t &= 1 \\ P &= (1 - 1)P_1 + 1 \cdot P_2 \\ &= 0 \cdot P_1 + 1 \cdot P_2 \\ &= 0 + P_2 \\ &= P_2 \end{aligned} $$

1차 베지에 곡선(선형 보간) 공식은 다음과 같이 수식을 전개하여 보다 직관적으로 나타낼 수 있다.

$$ \begin{aligned} P &= P_1-tP_1+tP_2 \\ &= P_1+tP_2-tP_1 \\ &= P_1+t(P_2-P_1) \end{aligned} $$

2차 베지에 곡선 (조절점 3개)

조절점이 3개일 때 공식은 아래와 같다. 1차 베지에 곡선의 원리를 재귀적으로 적용한 것으로 기본적인 원리는 다르지 않다. 어떤 과정을 거쳐 아래 공식이 도출되는지 하나하나 살펴보자.

$$ P = (1 - t)^2 P_1 + 2(1 - t)t P_2 + t^2 P_3 $$

먼저 2차 베지에 곡선에 필요한 3개의 조절점—시작 $P_1$, 중간 $P_2$, 끝 $P_3$—이 있다고 가정해 보자. 이 세 점을 이용해 두 개의 동적인 점을 만든다.

$P_1$에서 $P_2$로 이동하는 점 $Q_1 = (1-t)P_1+tP_2$
$P_2$에서 $P_3$으로 이동하는 점 $Q_2 = (1-t)P_2+tP_3$

매개변수 $t$가 0에서 1로 변함에 따라, $Q_1$은 $P_1$에서 $P_2$로, $Q_2$는 $P_2$에서 $P_3$으로 일정하게(선형적) 이동한다. 2차 베지에 곡선 위의 최종적인 점 $P$는 이렇게 움직이는 두 점 $Q_1$, $Q_2$를 다시 $t$에 대해 선형 보간하여 얻을 수 있다. 즉, $Q_1$을 시작점으로 $Q_2$를 끝점으로 갖는 또 다른 1차 베지에 곡선을 만드는 것이다.

$$ P = (1-t)Q_1 + tQ_2 $$

이제 위 공식에 $Q_1$과 $Q_2$ 정의를 각각 대입해 보자.

$$ \begin{aligned} P &= (1-t){\color{cyan}Q_1} + {\color{orange}tQ_2} \\ &= (1-t){\color{cyan}((1-t)P_1 + tP_2)} + {\color{orange}t((1-t)P_2 + tP_3)} \end{aligned} $$

분배법칙을 이용해 곱셈을 전개한다.

$$ P = {\color{cyan}(1-t)(1-t)P_1 + (1-t)tP_2} + {\color{orange}t(1-t)P_2 + t \cdot tP_3} $$

거듭제곱(²)을 사용해서 식을 정리한다.

$$ P = {\color{yellowgreen}(1-t)^2P_1} + (1-t)tP_2 + t(1-t)P_2 + {\color{yellowgreen}t^2P_3} $$

가운데 있는 2개의 $P_2$ 항은 곱의 순서만 다를 뿐 동일하므로(동류항) 하나로 합쳐준다. 그럼 2차 베지에 곡선의 공식이 완성된다.

$$ P = (1-t)^2P_1+{\color{yellowgreen}2(1-t)tP_2}+t^2P_3 $$

3차, 4차 등 더 높은 차수의 베지에 곡선도 위와 동일한 원리가 재귀적으로 적용되어 만들어진다.

참고로 각 조절점 앞에 곱해진 $(1-t)^2$, $2(1-t)t$, $t^2$ 같은 항들을 번스타인 기저 다항식(Bernstein basis polynomials)이라고 부른다. 이러한 항들은 $t$ 값에 따라 각 조절점이 곡선 위의 점 $P$에 얼마나 큰 영향(가중치)을 미치는지 결정한다.

베지에 곡선의 기울기

아래는 다양한 베지에 곡선 예시.

Image via Josh Collins Worth

베지에 곡선 그래프에서 x축은 시간의 흐름(지속 시간), y축은 애니메이션의 진행률을 나타낸다. 이때 곡선의 기울기가 그 순간의 속도가 된다. 따라서 기울기가 가팔수록 빠르게, 완만할수록 느리게 움직이는 효과를 낼 수 있다.

Image via Josh Collins Worth

x축은 애니메이션의 전체 지속시간을 1로 정규화했으므로 항상 0~1 범위로 지정해야 하지만, y축은 목표값 1을 넘어섰다가 다시 돌아오는 패턴을 활용해서 바운스 효과를 만들 수 있다.

[0 → 0.5 → 0.8] → [1.1] → [0.95 → 1.02 → 0.98] → [1.0]
     가속구간       오버슈트         바운스              도달

가속 구간 (0 → 0.8): 기울기가 증가하면서 점점 빨라짐
오버슈트 (1.1): y 값이 1.1에 도달했을 때 순간적으로 속도가 0이 된 후 운동 방향 전환
바운스 (0.95 → 1.02 → 0.98): 목표값을 중심으로 y값이 위아래로 여러 번 출렁이는 구간
도달 (1.0): 목표값에 도달하여 멈추는 구간

예를 들어 cubic-bezier(0.34, 1.56, 0.64, 1) 처럼 설정하면 오버슈트 효과를 만들 수 있다. 참고로 오버슈트(Overshoot)는 목표 지점(1)을 의도적으로 넘어갔다가 다시 목표 지점으로 되돌아오는 움직임이고, 언더슈트(Undershoot)는 반대로 시작 지점(0)보다 더 뒤로 갔다가 다시 목표 지점으로 향하는 움직임을 의미한다.

코드 및 데모

베지에 곡선 애니메이션 구현 코드(타입스크립트)는 리포지토리 링크에서 확인할 수 있다. 아래는 구현 결과를 렌더링한 화면(데모 링크). 셀렉트 박스를 눌러서 곡선의 차수(Degree)를 직접 변경할 수 있다.

레퍼런스

[JS] async 함수가 await를 만났을 때 동작 흐름

ColorFilter — Sat, 14 Jun 2025 14:43:00 +0900

TL;DR

async/await는 비동기 코드를 동기 코드처럼 작성할 수 있도록 해주는 문법적 설탕(Syntax Sugar)이다. 내부적으로는 async 함수 실행을 일시 중단했다가 프로미스가 처리되면 마이크로태스크 큐를 통해 다시 재개하는 방식으로 논블로킹을 유지한다.

async/await는 함수 실행을 중단/재개할 수 있는 제너레이터와 프로미스를 활용해서 구현되어 있으며, await 이후의 코드는 사실상 .then() 메서드의 콜백 함수라고 볼 수 있다.

promise.then(() => { /* await 이후의 코드 */ })

async/await 내부 메커니즘

async 함수를 호출하면 await 키워드를 만나기 전까지 일반 함수처럼 동기적으로 실행.
async 함수 실행 중 await 키워드를 만나면 해당 지점에서 함수 실행을 일시 중지하고, 호출자에게 제어권 반환. 백그라운드에선 Promise 처리 시작.
async 함수가 일시 중지(suspend)된 동안 JS 런타임은 호출자 컨텍스트의 다음 동기 코드 계속 실행. 덕분에 메인 스레드가 블로킹되지 않고, UI 렌더링 같은 다른 작업을 지연 없이 처리할 수 있음.
프로미스가 처리(이행 혹은 거부)되면, 중단 지점 이후의 코드가 마이크로태스크 큐에 추가되고, 이벤트 루프에 의해 콜스택에 들어가서 실행 재개. 이때 await 표현식은 이행된 값을 반환하며, 거부된 경우 예외 throw.
나머지 동기 코드 실행. async 함수 안에 또 다른 await를 만나면 2-4 과정 반복.

async/await 실행 흐름 예제

function main() {
  // Promise 생성자가 받는 executor 함수 자체는 동기적으로 실행됨
  return new Promise((resolve) => {
    console.log(3);
    resolve(4);
    console.log(5);
  });
}

async function f() {
  console.log(2);
  let r = await main(); // 여기서 f() 실행 일시 중단
  console.log(r); // main() 프로미스 처리 후 실행
}

console.log(1);
f();
console.log(6);

// 1, 2, 3, 5, 6, 4

console.log(1) : 전역 스코프의 동기적 코드 실행
f() 함수 호출
- console.log(2) : 함수 내부의 동기적 코드 실행
- main() 함수 호출
  - console.log(3) : 실행자 함수 내부의 동기적 코드 실행
  - resolve(4) : 프로미스를 이행(fulfilled) 상태로 변경 → 이 시점에 await로 대기중인 f() 함수의 나머지 부분이 마이크로태스크 큐에 등록됨
  - console.log(5) : 실행자 함수 내부의 동기적 코드 실행
  - main() 함수는 이행된 상태의 프로미스 반환
- main() 함수가 반환한 프로미스를 확인하고, f() 함수 실행 일시 중단 및 전역 스코프로 제어권 반환
console.log(6) : 전역 스코프의 동기적 코드 실행
f() 함수의 나머지 코드 실행 → 콜스택이 비어있는걸 확인한 이벤트 루프가 마이크로태스크 큐의 작업을 콜스택에 추가함
- await 표현식에서 프로미스 결과값 4 반환
- console.log(4) : 함수 내부의 동기적 코드 실행

위 코드의 비동기 처리 과정을 시퀀스 다이어그램으로 표현해보면 아래와 같다.

[CSS] grid-row 동작 방식 살펴보기

ColorFilter — Tue, 3 Jun 2025 20:28:04 +0900

grid-row-start, grid-row-end 속성은 그리드 아이템이 어느 행 라인부터 시작하여 어느 행 라인에서 끝날지 지정할 때 사용한다. 이 속성은 그리드 아이템(그리드 컨테이너의 직계 자식 요소) 자체에 적용한다. 참고로 그리드 라인은 컨테이너 시작 지점부터 1, 2, 3, … 양수 번호가 부여되고, 컨테이너 끝 지점부터는 -1, -2, -3, … 음수 번호가 부여된다.

/* 그리드 아이템이 1~2번 라인 차지(첫 번째 행 트랙) */
grid-row-start: 1; 
grid-row-end: 2;

grid-row-start: 1; grid-row-end: 2;

span은 그리드 아이템이 차지할 트랙의 개수를 지정할 때 사용한다. 여기서 트랙(track)이란 두 그리드 라인 사이의 공간을 의미한다. 그리드 셀 1개는 기본적으로 하나의 행 트랙과, 하나의 열 트랙이 교차하여 만들어지는 최소 단위 공간으로, 한 칸을 의미한다. 예를 들어 span 2 를 사용하면 아이템이 2개의 행(또는 열) 트랙을 차지하도록 지정할 수 있다.

grid-row-start: auto; /* 브라우저가 자동으로 아이템 행 시작 위치 결정 */
grid-row-end: span 2; /* 그리드 아이템이 시작 지점부터 2개 행 차지 */

grid-row-start: auto; grid-row-end: span 2;

grid-row 속성은 행 시작 위치(첫 번째 값; grid-row-start)와 종료 위치(두 번째 값: grid-row-end)를 한 번에 지정할 수 있는 단축 속성이다. 두 값은 슬래시 / 를 이용하여 구분한다.

grid-row: auto / span 2;

/*
아래와 동일
grid-row-start: auto;
grid-row-end: span 2;
*/

grid-row 속성의 두 번째 값을 생략하면 grid-row-end 값은 auto(하나의 트랙만 차지)로 설정된다.

grid-row: 2;

/*
아래와 동일 (2~3번 라인 차지)
grid-row-start: 2;
grid-row-end: auto;
-> grid-row-end: 3 혹은 grid-row-end: span 1 과 동일하게 동작
*/

시작/종료 라인 모두 동일한 span 값을 지정하면, grid-row-end만 지정한 것처럼 동작한다. CSS 명세에 따르면, 시작/종료 라인 값이 같을 경우 종료 라인은 무시되어 auto로 처리된다. 시작 라인이 span, 종료 라인이 auto 일 땐, 시작 라인 auto, 종료 라인 span으로 지정한 것과 동일하게 동작한다(참고글).

참고로 Tailwind CSS의 row-span-2 같은 클래스도 내부적으로 grid-row: span 2 / span 2 형태로 지정되어 있기 때문에 결과적으로 grid-row: auto / span 2와 동일하다고 볼 수 있다.

grid-row: span 2 / span 2;

/*
아래처럼 동작 (현재 위치에서 2개의 행 트랙 차지)
grid-row-start: auto;
grid-row-end: span 2;
*/

속성 값에 span 키워드를 단독으로 사용했을 때도 시작 라인 auto, 종료 라인 span으로 해석돼서 gird-row-end만 지정한 것처럼 동작한다.

grid-row: span 2;

/*
grid-row: span 2 / auto;
-> grid-row: auto / span 2; 처럼 동작
*/

grid-column, grid-row는 각각 수평(열), 수직(행) 방향 차이만 있을 뿐 속성의 동작 원리는 동일하다.

[HTTP] ETag 엔티티 태그 헤더

ColorFilter — Mon, 5 May 2025 22:35:06 +0900

TL;DR

ETag(엔티티 태그; Entity Tag)는 HTTP 응답 헤더 중 하나로, 웹 리소스의 특정 버전을 식별하기 위한 고유한 식별자다. 클라이언트는 ETag를 이용해 리소스 변경 여부를 서버에 검증하고, 변경되지 않았으면 캐시 된 콘텐츠를 재사용함으로써 대역폭을 절약하고 성능을 개선할 수 있다.

작동 방식

클라이언트가 특정 리소스를 처음 요청하면, 서버는 응답 헤더에 ETag 값을 포함하여 리소스와 함께 전달
클라이언트는 응답으로 받은 ETag 값 저장
이후 동일한 리소스 재요청 시 If-None-Match 요청 헤더에 ETag 값을 담아서 서버로 전송
서버는 전달받은 ETag 값과 현재 리소스의 ETag 값 비교
- 값이 일치하면 본문(body)은 생략하고 304 Not Modified 반환
- 값이 일치하지 않으면 최신 리소스와 새로운 ETag 값을 담아서 200 OK 반환

ETag 종류

ETag는 검증 강도에 따라 Strong ETag와 Weak ETag 두 가지 종류로 나뉜다.

Strong ETag
- 리소스 내용이 바이트 단위까지 완전히 일치해야 같은 값으로 간주
- 리소스가 조금이라도 변경되면 ETag 값이 변경됨
- 표기 예시: "abcdefg" (접두사 없음)
Weak ETag
- 리소스가 의미상 동일하다면 바이트 단위 차이를 무시하고 같은 값으로 간주
- 광고 배너, 동적 타임스탬프 등 의미 없는 변경을 허용할 때 주로 사용
- 표기 예시: W/"abcdefg" (W/ 접두사 추가)

Weak ETag는 의미에 영향을 주지 않는 부분(동적 타임스탬프, 광고 배너 등)을 제거하거나 정규화한 뒤, 남은 콘텐츠를 해시(hash)하여 생성한다. 정규화란 원본 데이터에서 불필요하거나 의미 없는 부분을 제거하고, 일정한 형태로 통일하는 과정을 의미한다. 예를 들어, HTML 타임스탬프는 다음과 같이 정규화할 수 있다.

<!-- 정규화 전 -->
<div class="updated">2025-05-04 12:34</div>
<!-- 정규화 후 -->
<div class="updated"></div>

ETag 값

ETag 값은 일반적으로 큰따옴표로 감싼 문자열 형태로 표현하며, 별도의 표준 포맷은 없지만 주로 다음과 같은 방식으로 생성한다.

콘텐츠 내용의 해시 값 (MD5, SHA1 등)
마지막 수정 시간의 해시 값
단순한 리비전 번호 또는 버전 번호

업데이트 손실

여러 클라이언트가 동일한 리소스를 거의 동시에 읽고 각각 수정을 시도하면, 나중에 처리된 변경이 앞선 변경을 덮어쓰는 업데이트 손실(Lost Update) 문제가 발생할 수 있다. 이를 방지하기 위해 If-Match 헤더를 사용하여 클라이언트가 보유한 ETag와 서버의 ETag가 일치할 때만 변경 작업을 수행하도록 조건부 요청을 보낼 수 있다.

클라이언트 A, B가 동시에 리소스 조회
- A와 B가 각각 GET 요청
- 서버는 ETag: "v1" 응답
A가 먼저 변경 요청
- A는 If-Match: "v1" 헤더와 함께 PUT 요청
- 서버는 ETag 일치 확인 후 업데이트 수행 → ETag를 "v2"로 갱신하고 200 OK 반환
B가 뒤이어 변경 요청
- B는 여전히 ETag: "v1"를 사용하여 PUT 요청
- 서버의 ETag는 이미 "v2"이므로 B의 ETag와 불일치 → 412 Precondition Failed 반환

만약 3번에서 조건 없이 B의 내용으로 덮어쓴다면 A의 변경 내용이 사라지는 문제가 발생한다. If-Match 조건이 실패했을 땐 일반적으로 412 Precondition Failed로 응답한다. 요청이 거부된 클라이언트가 충돌을 해결하려면 최신 리소스를 다시 GET 해야 한다.

ETag와 Cache-Control

Cache-Control은 브라우저와 중간 서버(Proxy, CDN 등)가 어떤 방식으로 응답을 캐싱할지 지정하는 헤더로, 캐싱 가능 여부(public, private, no-store), 캐시 유효 기간(max-age), 재검증 방식(no-cache, must-revalidate) 등을 설정할 수 있다.

Cache-Control과 ETag는 웹 캐싱 전략에서 상호 보완적인 역할을 수행하여, 함께 사용하면 더 효율적인 캐싱 정책을 구현할 수 있다.

자주 변경되는 동적인 리소스는 no-cache 설정을 적용하여 매번 서버에 재검증을 요청하게 하고, ETag를 통해 콘텐츠가 변경되지 않았을 땐 304 Not Modified로 응답하여 불필요한 데이터 전송을 줄일 수 있다.

Cache-Control: no-cache
ETag: "v123"

no-cache: 캐시 데이터 사용 전 매번 원본 서버에 재검증
must-revalidate: 만료된 캐시 데이터는 원본 서버 재검증 없이 사용 불가

변경이 거의 없는 정적인 리소스는 max-age와 immutable을 함께 설정하여 유효 기간 동안 서버 재검증 요청 없이 캐시 된 응답을 사용하도록 한다. max-age 기간 동안 ETag를 이용한 재검증이 일어나지 않지만, 캐시가 만료되거나 immutable을 지원하지 않는 일부 환경에서의 재검증을 위해 ETag를 함께 보내는 것이 일반적이다.

Cache-Control: max-age=31536000, immutable
ETag: "abc456"

public: 브라우저와 중간 서버(프록시, CDN 등) 모두 응답을 캐싱하고 재사용할 수 있도록 허용
max-age=31536000: 캐시 생성 후 1년(31,536,000초) 동안 fresh 상태 유지
immutable: 유효 기간 내 리소스가 변경되지 않음을 나타내며, 해당 기간 동안 브라우저가 재검증 요청을 보내지 않도록 지시

레퍼런스

ETag - HTTP | MDN

ETag HTTP 응답 헤더는 특정 버전의 리소스를 식별하는 식별자입니다. 웹 서버가 내용을 확인하고 변하지 않았으면, 웹 서버로 full 요청을 보내지 않기 때문에, 캐쉬가 더 효율적이게 되고, 대역폭

developer.mozilla.org

[JS] 자바스크립트 6줄로 이미지 비교 슬라이더 만들기

ColorFilter — Thu, 17 Apr 2025 20:27:32 +0900

이미지 비교 슬라이더는 핸들을 좌우로 움직여서 두 이미지를 비교할 수 있는 UI 패턴으로 쇼핑몰이나 제품 소개 페이지 등에서 자주 볼 수 있다. 이러한 이미지 비교 슬라이더는 range 타입의 input 태그와 6줄 정도의 자바스크립트 코드만으로 구현할 수 있다.

이미지 출처 CopyHouse

range 타입의 input은 슬라이드바를 조정하여 범위 내 숫자 값을 선택할 수 있는 입력 필드다. 기본적으로 브라우저에서 제공하는 스타일이 적용되어 있다. 이 기본 스타일을 모두 제거하고 이미지의 너비/높이만큼 크기를 확장하면, 슬라이더 영역을 클릭 혹은 드래그할 때마다 (스타일을 제거해서 화면에 보이지 않는) 핸들이 해당 위치로 이동해서 값이 변경된다.

range input 기본 스타일 via MDN

기본적인 구현 방법은 다음과 같다.

이미지 1, 이미지 2를 감싸는 마스크 요소, range input, 구분선(Separator) 및 커스텀 핸들 이렇게 4개 레이어를 포개지도록 구성한다. 핸들을 움직일 때마다 슬라이더(range input) 값 만큼 마스크 요소의 너비를 조정하고, 넘치는 부분은 보이지 않도록 처리하면(overflow: hidden) 기본적인 이미지 비교 슬라이더가 완성된다.

이미지 비교 슬라이더 레이어 구성. Separator는 Image Mask 가장 우측에 위치시킨다.

HTML 구조

첫 번째 이미지는 .compare-img-one 클래스로 직접 배치하고(가장 하단), 두 번째 이미지는 마스킹 처리를 위해 .compare-mask 요소 안에 포함되도록 한다. 두 번째 이미지는 첫 번째 이미지 위에 겹친 상태로 위치하게 된다. 구분선과 커스텀 핸들은 .compare-mask 우측 끝에 위치해서 이미지 1과의 경계를 나타낸다.

.compare-input 요소는 클릭 혹은 드래그 이벤트를 처리하기 위해 가장 상단에 위치하게 된다. 참고로 HTML 문서에서 하단에 작성한 요소일수록 화면에선 위에 표시된다.

<section class="compare">
  <!-- 이미지 1 -->
  <img class="compare-img-one" src="..." />
  <!-- 이미지 2 마스크 -->
  <div class="compare-mask">
    <!-- 이미지 2 -->
    <img class="compare-img-two" src="..." />
  </div>

  <!-- 이미지 1, 2 구분선 -->
  <div class="compare-separator">
    <!-- 커스텀 핸들 (svg 속성 및 path 생략) -->
    <svg class="compare-icon"><!-- ... --></svg>
  </div>

  <!-- range input -->
  <input class="compare-input" type="range" min="0" step="0.5" max="100" />
</section>

CSS

컨테이너

자식 요소들을 컨테이너인 .compare 요소 기준으로 배치하기 위해 position: relative 속성을 설정한다. 필요한 CSS 변수도 컨테이너에 정의한다. 부모 요소에서 정의한 CSS 변수는 자식 요소에서 참조할 수 있다.

.compare {
  --mask-width: 50%; /* slider value */
  --handle-size: 33px;

  position: relative;
}

이미지 1

Baseline (베이스라인): 글자 아래에 있는 가상의 선. 텍스트 요소는 글자마다 높이가 다르더라도 이 선을 기준으로 나란히 배치된다. g, j, p, q, y 같은 글자는 꼬리 부분이 베이스라인 아래로 내려간다. 이렇게 베이스라인 하단으로 확장되는 부분은 Descender라고 부른다.

이미지 태그의 display 속성 기본값은 inline이기 때문에 텍스트처럼 베이스라인 기준으로 정렬된다. 이때 이미지 하단에 descender를 가진 글자들을 위한 공간이 자동으로 생성된다. 이 하단 여백을 없애고 싶으면 이미지의 display 속성을 block으로 설정하면 된다.

.compare-img-one {
  width: 100%; /* 부모 요소 너비만큼 이미지 크기 제한 */
  display: block; /* 이미지 아래 생성되는 하단 여백을 없애기 위해 block으로 변경 */
}

이미지 2 마스크

이미지 마스크는 컨테이너를 기준으로 위치해야 하므로 position: absolute를 설정한다. 슬라이드 핸들을 조정할 때마다 슬라이더 값이 --mask-width CSS 변수에 반영되며, 이 값은 이미지 마스크 요소의 너비로 적용된다. 만약 --mask-width 가 50%라면 이미지 2는 절반만 표시된다. 나머지 영역은 overflow: hidden 속성에 의해 잘림 처리되고, 그 아래에 있던 이미지 1이 표시된다.

.compare-mask {
  position: absolute;
  inset: 0;
  width: var(--mask-width);
  height: 100%;
  overflow: hidden;
}

.compare-img-two {
  height: 100%;
  /* width: auto 기본값 -> 원본 이미지 너비로 렌더링 */
}

이미지 구분선, 커스텀 핸들

현재 설정된 이미지 마스크 너비만큼 구분선을 오른쪽으로 이동시키면 이미지 마스크 바로 우측(화면에 보이는 이미지 1 시작 지점)에 위치하게 된다. 이 상태에서 구분선 너비의 절반만큼 다시 왼쪽으로 이동하면 정확히 두 이미지의 경계에 걸치게 된다.

.compare-separator {
  position: absolute;
  inset: 0;
  width: 2px;
  height: 100%;
  left: var(--mask-width); /* 마스크 너비만큼 오른쪽으로 이동 */
  translate: -50%; /* 자신 너비의 50% 만큼 왼쪽으로 이동(1px) */
  background: var(--bg-color);
}

커스텀 핸들 역시 top, left, translate 속성을 이용해서 경계선 중앙에 걸치도록 작성한다. 참고로 대부분의 브라우저에선 translate, rotate, scale 등의 속성을 독립적인 CSS 속성으로 사용할 수 있다. 2021년 이전의 구형 브라우저에선 여전히 transform: translate(x, y) 형태로 사용해야 한다.

.compare-icon {
  position: absolute;
  top: 50%;
  left: var(--mask-width);
  width: var(--handle-size);
  height: var(--handle-size);
  translate: -50% -50%;
  padding: 6px;
  color: var(--bg-color);
  background: white;
  stroke-width: 2px;
  border: 2px solid currentColor;
  border-radius: 50%;
}

Range Input

커스텀 핸들 코드를 잠시 제거한 뒤 가장자리로 드래그해 보면, 구분선과 핸들 사이에 간격이 생기는 것을 확인할 수 있다. 이 간격은 정확히 핸들 너비의 절반만큼 벌어진다. 핸들이 슬라이드 영역을 벗어나지 않도록 내부적으로 일정 비율만큼 이동을 제한하기 때문에 이러한 현상이 발생하는 것.

아래 이미지처럼 슬라이더(range input) 양쪽에 핸들 너비의 절반만큼(벌어진 간격) 공간을 추가하면, 핸들의 중심이 슬라이더 끝점에 정확히 위치해서 문제가 해결된다.

.compare-input {
  appearance: none; /* 슬라이더 기본 스타일 제거 */
  background: none; /* 슬라이더 배경 제거 */

  position: absolute;
  inset: 0; /* 네 방향의 여백을 모두 0으로 설정하면 부모 요소 크기만큼 채움 */
  cursor: col-resize;

  /* 핸들의 중심이 슬라이더 끝점에 위치할 수 있도록 조정 */
  width: calc(100% + var(--handle-size));
  left: calc(var(--handle-size) / -2);
}

커스텀 핸들 아이콘을 사용하기 위해 ::-webkit-slider-thumb 가상 요소에 appearance: none; 속성을 추가하여 브라우저 기본 스타일을 제거한다. 이때 width 값을 지정하지 않으면 핸들이 슬라이더 트랙 너비만큼 확장되는 현상이 발생하므로 커스텀 핸들 크기에 맞게 너비를 설정해준다.

.compare-input::-webkit-slider-thumb {
  appearance: none; /* Range Input 기본 핸들 스타일 제거 */
  width: var(--handle-size); /* width 지정 안하면 트랙 꽉 채움 */
}

JavaScript

부모 요소에 선언한 CSS 변수는 자식 요소에서 참조할 수 있으며, 자식 요소에서 동일한 변수 이름으로 재정의(오버라이드)할 수도 있다.

자바스크립트 코드는 복잡한 로직 없이 range input 이벤트 핸들러만 할당하면 된다. input 이벤트가 발생할 때마다(슬라이드 핸들 드래그) --mask-width CSS 변수 값을 업데이트하면, 해당 변수를 사용하는 이미지 마스크, 구분선, 커스텀 핸들에 바로 반영된다.

const $compare = document.querySelector(".compare");
const $compareInput = document.querySelector(".compare-input");

// range input 값이 변경될 때마다 --mask-width CSS 변수 업데이트
// .compare 자식 요소에서 해당 CSS 변수를 사용한다면 변경된 값이 적용됨
$compareInput.addEventListener("input", (e) => {
  $compare.style.setProperty("--mask-width", `${e.target.value}%`);
});

완성 CodePen

레퍼런스

무료 이미지 호스팅 구축하기 (Cloudflare R2 + PicGo + WebP Cloud)

ColorFilter — Sun, 6 Apr 2025 23:23:53 +0900

이미지 호스팅은 이미지 파일을 웹 서버에 저장하고 인터넷을 통해 접근할 수 있도록 해주는 서비스다. 이미지를 저장/관리/공유하거나 블로그/웹사이트를 운영한다면 이미지 호스팅이 필요할 수 있다. 기존 클라우드 서비스나 전문 이미지 호스팅 서비스는 용량이 늘어날수록 비용 부담이 증가하고 이미지 최적화를 위한 별도의 관리가 필요하다. 서비스 제공업체의 정책 변경이나 서비스 종료 같은 위험성도 존재한다.

오늘은 Cloudflare R2, PicGo, WebP Cloud를 이용해 이미지 호스팅을 직접 구축하는 방법을 소개할까 한다. 개인적인 용도로 사용한다면 각 서비스의 무료 요금제(Free tier)로도 충분히 사용할 수 있다. 특히 Cloudflare R2는 330개 이상 데이터 센터로 구성된 글로벌 네트워크를 통해 안정적인 데이터 접근을 보장하고, 무엇보다 이그레스 비용(외부로 데이터 전송)이 없다는 장점이 있다.

이그레스(Egress) 비용은 클라우드에서 외부로 나가는 데이터에 대해 부과하는 요금을 의미한다. 예를 들어 스토리지에 저장된 이미지를 웹 브라우저에서 로드하거나 다운로드할 때도 이그레스 트래픽이 발생한다.

서비스	용도	무료 플랜 제공
Cloudflare R2	S3 호환 오브젝트 스토리지 서비스	매월 10GB 저장 공간
PicGo	이미지 업로드 도구. GUI/CLI 지원	오픈소스 (무료)
WebP Cloud	이미지 프록시 (이미지 최적화)	하루 3000건 요청, 200MB 캐시

Cloudflare R2 버킷에 업로드한 이미지는 WebP Cloud라는 이미지 프록시 서비스를 이용해 최적화된 형태로 불러올 수 있다. URL 파라미터를 통해 이미지 리사이즈, 퀄리티 조정, 워커마크 추가 등 다양한 기능도 제공한다.

위 서비스들을 이용해 이미지 호스팅을 구축하면 아래 과정을 거쳐 이미지를 처리하게 된다.

이미지 업로드: PicGo 이용해서 이미지 업로드 → R2 버킷에 원본 이미지 저장 → WebP Cloud URL 반환
이미지 요청: WebP Cloud URL로 이미지 요청 → R2 버킷에서 불러온 원본 이미지를 WebP/AVIF로 최적화하여 응답 후 캐싱. 이후 동일한 이미지로 요청을 받으면 캐싱한 이미지로 빠르게 응답

이미지 요청/응답 과정

Cloudflare R2 버킷 생성

① Cloudflare 대시보드 → R2 개체 저장공간 → 신용카드 연동(무료 사용량 초과 시 요금 청구). 클래스 A 작업은 쓰기, 업로드 등에 해당되고 클래스 B 작업은 읽기, 조회 등에 해당된다.

② 버킷 생성

버킷 이름: 임의 입력
위치: 자동 (WebP Cloud 리전이 Hillsboro, OR에 위치하므로 위치 힌트를 서부 북아메리카로 선택)
기본 저장 공간 클래스: 표준

③ 버킷 → 설정 → "사용자 설정 도메인 추가"에서 도메인 연동. 연동한 도메인을 통해 버킷 콘텐츠에 공개적으로 액세스할 수 있다. 만약 도메인이 없다면 R2.dev 하위 도메인을 활성화해서 공개적으로 액세스할 수도 있지만 속도 제한이 있는 단점이 있다.

④ R2 개요 페이지 → { } API ⏷ 버튼 → API 토큰 관리 → API 토큰 생성

토큰 이름: 임의 입력
권한: 개체 읽기 및 쓰기
버킷 지정: "특정 버킷에만 적용" 선택 후 생성한 버킷 선택

⑤ 생성한 API 토큰 값, 액세스 ID/키, 엔드포인트 주소는 안전한 곳(비밀번호 관리자 등)에 저장

WebP Cloud 설정 (이미지 최적화)

Free 플랜은 하루 3000건 요청, 200MB 캐시, 대역폭 무제한, 최대 3개의 프록시를 생성할 수 있다. WebP Cloud는 요청받은 이미지에 대해 WebP/AVIF 포맷으로 변환한 후 최적화된 이미지를 제공한다.

만약 일일 한도(Quota)를 초과했다면 원본 이미지 주소로 301 리다이렉트되고, 캐시 용량을 초과한 경우에는 LRU(Least Recently Used) 알고리즘에 따라 가장 오래 사용하지 않은 캐시부터 순차적으로 삭제된다.

프록시 생성

① WebP Cloud 로그인 후 Create Proxy 버튼 클릭

② 프록시 생성

Proxy Region: Hillsboro, OR (미국 서부 북아메리카)
Proxy Name: 임의 입력
Proxy Origin URL: R2 버킷에 설정한 도메인 혹은 R2.dev 주소

③ 생성한 프록시 페이지에서 WebP Cloud URL 복사. 필요 시 커스텀 도메인을 설정할 수도 있다.

적응형 크기 조절

프록시 대시보드에서 Adaptive Resize 기능을 통해 데스크톱/모바일에 대한 최대 이미지 너비를 설정할 수 있다. 이 기능을 활성화하면 브라우저의 User Agent 헤더를 기반으로 데스크톱/모바일 사용 여부를 판단한 후, 설정한 기기 너비보다 더 큰 이미지는 자동으로 비율에 맞춰 리사이즈된다.

예를 들어 데스크톱 최대 너비를 1600(px)으로 설정했다면, 데스크톱으로 접속했을 때 너비가 2000인 이미지는 1600으로 자동 리사이즈된다. 이를 통해 이미지 용량을 줄이고 렌더링 속도를 향상할 수 있다.

이미지 조작

WebP Cloud는 URL 파라미터를 통해 이미지 조작 기능을 제공한다. 아래 표에 있는 기능 외에도 워터마크 추가, 이미지 필터, 커스텀 헤더 등 다양한 기능을 제공한다. 자세한 내용은 공식 문서 참고.

기능	파라미터 예시	조정 범위	참고
크기 조정	`?width=200`
수직 뒤집기	`?flip=v`	`v`
수평 뒤집기	`?flip=h`	`h`
퀄리티 조정	`?quality=60`	10~100	100은 무손실 변환
블러 효과	`?blur=10`	10~100
선명함	`?sharpen=5`	1~10
회전	`?rotate=90`	0~360
밝기	`?brightness=0.2`	0~10	1은 변경없음
채도	`?saturation=0`	0~10	1은 변경없음
색조	`?hue=45`	0~360	0은 변경없음
대비	`?contrast=0.5`	0~10	1은 변경없음

PicGo 설정 (이미지 업로드)

PicGo 언어가 중국어로 나온다면 PicGo设置(설정) → 选择语言(언어 선택) 메뉴에서 영어로 변환할 수 있다. 중국 개발자가 만든 플러그인이 다국어(영어 등)를 지원하지 않는다면 중국어 메뉴로 표시될 수 있다.

① Release 페이지에서 최신 버전 다운로드/설치. 패키지 매니저를 통해 설치할 수도 있다(아래 명령어 참고).

# Homebrew (macOS)
brew install picgo

# Chocolatey (Windows)
choco install picgo

② PicGo Main Window → Plugins Settings → s3 검색 후 설치 (wayjam 개발자)

③ PicGo Main Window → Picbeds Settings → Amazon S3 클릭 후 설정

Configuration Name: 임의 입력
应用密钥 ID: Cloudflare에서 생성한 API 액세스 키 ID
应用密钥: Cloudflare에서 생성한 API 액세스 키
桶名: Cloudflare 버킷 이름
上传文件路径: 이미지 저장 경로/파일명 (파일명만 입력하면 루트 경로에 저장)
- 파일명.확장자 지정 예시: {fileName}.{extName}
- 경로/파일명.확장자 지정 예시: {year}/{month}/{md5}.{extName}
自定义节点: Cloudflare API 엔드포인트 주소
自定义输出URL模板: 이미지 업로드 후 생성되는 URL 형식 (도메인 부분에 WebP Cloud URL 입력)
- 예) https://abc.webp.li/{fileName}

정상적으로 설정했다면 PicGo로 이미지를 업로드했을 때 WebP Cloud 주소가 생성된다. 브라우저 주소창에 생성된 이미지 주소로 접속해 보면 최적화된 이미지를 불러온다. 1.7MB 크기의 PNG 이미지를 업로드했을 때 최적화한 이미지 크기는 150KB 정도로 약 91% 줄어들었다. 상당한 감소다.

WebP Cloud를 사용했을 때 이미지 크기/퀄리티 변화 예시 via WebP Cloud

(번외) Typora 자동 이미지 업로드 설정

유명한 마크다운 에디터인 Typora는 PicGo를 연동한 이미지 업로드 기능을 지원한다. 마크다운 파일은 일반 텍스트 형식이기 때문에 이미지 파일을 포함하지 않고 외부 경로에 대한 참조만 유지한다. 만약 마크다운 파일을 이동하거나 공유할 경우 이미지 참조가 유실될 수 있다. PicGo를 이용해 이미지를 온라인에 자동 업로드하도록 설정하면 이러한 문제를 방지할 수 있다.

① Typora 설정 → 일반 → 언어 → 简体中文 선택 (PicGo App 항목은 중국어로 설정했을 때만 표시된다)

② Typora 재시작

③ 설정 → 图像(이미지)에서...

插入图片时 (이미지 삽입 시): 上传图片 (이미지 업로드)
上传服务 (이미지 업로더): PicGo.app 선택

④ 다시 원래 언어로 변경

설정 후 이미지를 Typora 창으로 드래그하면, 해당 이미지가 PicGo에서 설정한 호스팅 서비스로 자동 업로드되고, 업로드한 이미지의 링크가 마크다운 문서에 삽입되어 렌더링된다. 이미지 업로드 시 PicGo App이 실행 중이 아니라면 자동 실행된다. 만약 업로드할 때마다 앱이 실행되는 게 싫다면 PicGo Core(CLI)를 이용해서 설정할 수도 있다.

도메인	용도	차단 시 증상
`adison.co`	오퍼월(보상형 광고) 네트워크	네이버페이 미션/광고 콘텐츠 로드 불가
`pstatic.net`	네이버 CDN	네이버 서비스 일부 이미지 로드 불가