User scripts - XIYO/asuswrt-merlin.ng-kr GitHub Wiki

사용자 스크립트에 대하여

Asuswrt-Merlin은 원본 펌웨어에 비해 제한된 수의 새로운 기능만을 추가하지만, 사용자 스크립트를 통해 많은 사용자화를 달성할 수 있습니다. 이를 통해 사용자 정의 방화벽 규칙을 설정하고, 예정된 간격으로 실행될 작업을 만들거나, 새로운 서비스를 시작할 수 있습니다.

이러한 스크립트들은 JFFS 파티션 내부의 비휘발성 플래시에 저장됩니다. 이 스크립트들을 사용하려면, 웹 UI에서 Administration -> System에서 활성화해야 합니다.

사용 가능한 스크립트들:

이 쉘 스크립트들은 특정 이벤트가 발생할 때 실행됩니다. /jffs/scripts/에 저장되어야 합니다.

이 스크립트들은 일반적으로 이벤트와 병렬로 실행되지만, 명시적으로 차단 스크립트로 문서화된 경우를 제외하고는 그렇습니다. 그 경우, 스크립트는 스크립트가 완료되거나 타임아웃(현재 기본 타임아웃 값은 120초) 될 때까지 이벤트 자체의 실행을 차단합니다.

services-start

부팅 시 다른 모든 시스템 서비스가 시작된 후 호출됩니다. 예를 들어, 이 서비스 중 하나를 중단하고 다른 구성으로 다시 시작하는 것과 같은 작업에 적합한 장소입니다. (하지만 서비스가 수동으로 재시작될 때마다 원래 설정으로 돌아갈 것임을 알아두세요.)

services-stop

모든 시스템 서비스가 중단되기 전에, 보통 재부팅 시에 호출됩니다.

service-event

서비스 이벤트가 호출되기 전에 호출됩니다 (예: restart_httpd, restart_wireless 등). 첫 번째 인수는 이벤트입니다 (일반적으로 stop, start 또는 restart), 두 번째 인수는 대상입니다 (wireless, httpd 등). 이 스크립트는 차단 스크립트로, 스크립트가 완료되거나 타임아웃 될 때까지 이벤트 자체의 실행을 차단합니다.

service-event-end

펌웨어 384.11에서 도입되었습니다. 서비스 이벤트가 완료된 후에 호출됩니다 (예: restart_httpd, restart_wireless 등). 첫 번째 인수는 이벤트입니다 (일반적으로 stop, start 또는 restart), 두 번째 인수는 대상입니다 (wireless, httpd 등).

wan-event

WAN 인터페이스와 관련된 이벤트가 발생한 후에 호출됩니다. 스크립트는 두 개의 매개변수를 받습니다:

$1은 WAN 유닛을 포함합니다 (0은 기본, 1은 보조). $2는 이벤트 유형을 포함합니다. 다음 목록에서 가져옵니다 (목록은 펌웨어 버전에 따라 다를 수 있음):

• init
• connecting
• connected
• disconnected
• stopped
• disabled
• stopping

구 wan-start 스크립트는 "connected" 이벤트에서 발생했습니다. 연결된 이벤트가 발생한 후에는 인터넷 연결이 완

전히 기능적이지 않을 수 있습니다. 인터넷 액세스가 필요한 작업을 시도하기 전에 약간의 지연을 추가하거나, 연결이 기능적이 될 때까지 기다리는 코드를 작성하는 것이 좋습니다.

wan-start

(384.15부터 더 이상 사용되지 않으며, 대신 wan-event를 사용하세요)

WAN 인터페이스가 작동한 후에 호출됩니다. WAN 인터페이스에 의존하는 스크립트를 넣기에 좋은 장소입니다 (예: IPv6 터널 또는 동적 DNS 서비스 업데이트). 이 스크립트가 실행될 때 인터넷 연결이 활성화되어 있을 가능성은 낮습니다. 연결이 완료될 때까지 실행을 지연시키기 위해 sleep 라인을 추가하거나 명령이 성공할 때까지 루프를 실행하세요.

firewall-start

방화벽이 시작되고 필터링 규칙이 적용된 후에 호출됩니다. 이곳은 일반적으로 NAT 테이블이 아닌 필터 테이블에 자신만의 규칙을 넣을 곳입니다. 스크립트는 WAN 인터페이스 이름 (예: ppp0)을 인수로 받아 스크립트에서 $1을 사용하여 활용할 수 있습니다.

nat-start

NAT 규칙 (즉, 포트 포워드 등)이 NAT 테이블에 적용된 후에 호출됩니다. 이곳은 자신의 NAT 테이블 사용자 정의 규칙 (예: 특정 IP에서 오는 연결만 허용하는 포트 포워드)을 넣을 곳입니다.

init-start

JFFS가 마운트된 직후에, 그리고 어떤 서비스가 시작되기 전에 호출됩니다. 이것은 부팅 과정에서 무언가를 삽입할 수 있는 가장 이른 부분입니다.

pre-mount

파티션이 마운트되기 직전에 호출됩니다. 이것은 차단 호출로 실행되며 실행이 완료되거나 타임아웃 될 때까지 호출된 파티션의 마운트를 차단합니다. 이는 파티션을 마운트하기 전에 e2fsck와 같은 것을 실행하는 데 사용될 수 있습니다. 이 스크립트는 마운트되는 장치 경로 (예: /dev/sda1)를 인수로 받아 스크립트에서 $1을 사용하여 활용할 수 있습니다. 펌웨어 384.11부터 두 번째 인수 ($2)가 전달되며 파일 시스템 유형 (예: ext3)을 포함합니다.

post-mount

파티션이 마운트된 직후에 호출됩니다. 스크립트는 마운트 포인트 (파티션이 마운트된 파일 시스템 경로, 예: /tmp/mnt/OPT)를 인수로 받아 스크립트에서 $1을 사용하여 활용할 수 있습니다.

unmount

파티션을 마운트 해제하기 전에 호출됩니다. pre-mount처럼 이것도 차단 스크립트이므로 주의해서 사용하세요. 스크립트는 마운트 포인트를 인수로 받아 스크립트에서 $1을 사용하여 활용할 수 있습니다.

dhcpc-event

WAN 인터페이스에서 DHCP 이벤트가 발생할 때마다 호출됩니다. 이벤트 유형은 인수로 전달되며, 스크립트에서 $1을 사용하여 이를 활용할 수 있습니다. ASUSWRT의 udhcpc 버전에서 가능한 이벤트 유형은 deconfig (udhcpc가 시작되거나 임대가 손실될 때), bound (임대와 새 IP 주소가 획득될 때), 그리고 renew (임대가 갱신되지만 IP가 변경되지 않은 경우)입니다.

openvpn-event

OpenVPN 서버가 시작/중단되거나 OpenVPN 클라이언트가 원격 서버에 연결될 때마다 호출됩니다. OpenVPN의 "up" 및 "down" 스크립트와 동일한 구문/매개변수를 사용합니다. $script_type 환경 변수는 장치 $dev에서 발생한 이벤트의 유형을 나타냅니다.

ddns-start

DDNS 업데이트 프로세스가 끝날 때 호출됩니다. 이 스크립트는 DDNS 유형을 "Custom"으로 설정할 때도 호출됩니다. 스크립트는 WAN IP를 인수로 받으며, 스크립트에서 $1을 사용하여 이를 활용할 수 있습니다. "Custom" DDNS를 처리할 때, 이 스크립트는 업데이트 프로세스의 성공 또는 실패를 보고하는 책임도 있습니다. 자세한 내용은 Custom DDNS 섹션을 참조하세요.

update-notification

스케줄된 새 펌웨어 버전 가용성 체크가 새 펌웨어의 다운로드 가능성을 탐지했을 때 호출됩니다. 자세한 내용은 update notification example을 참조하세요.

qos-start

전통적인 QOS 또는 Cake가 중단/시작 스크립트를 생성한 후, 그리고 실행하기 전에 호출됩니다. 이 스크립트를 사용하여 /etc/cake-qos.conf 구성 파일(케이크에서 사용하는 변수를 포함) 또는 /tmp/qos(두 모드 모두에 대해 생성되어 tc qdisc/규칙 항목을 생성/제거하는 데 사용됨)을 수정할 수 있습니다. 이 스크립트는 매개변수로 하나의 인수를 받으며, "init" (QOS를 시작할 예정일 때) 또는 "rules" (전통적인 QOS에 대한 iptables 규칙이 구성되었을 때)를 포함할 것입니다. 이 스크립트는 차단 호출로 실행되며 완료될 때까지 QOS 시작을 일시 중지합니다.

wgserver-stop 및 wgserver-start

WireGuard 서버가 중단되거나 시작될 때 호출됩니다.

wgclient-stop 및 wgclient-start

WireGuard 클라이언트가 중단되거나 시작될 때 호출됩니다. 클라이언트 단위 번호(1-5)가 스크립트에 인수로 전달됩니다.

Postconf 스크립트

이 외에도, 펌웨어에서 지원하는 다수의 postconf 스크립트를 사용할 수 있으며, 서비스의 구성 파일이 생성된 순간과 서비스가 실행되기 직전 사이에 스크립트를 실행할 수 있습니다. 자세한 내용은 [Postconf scripts

](https://github.com/RMerl/asuswrt-merlin.ng/wiki/Custom-config-files#postconf-scripts) 섹션을 참조하세요.

스크립트 생성

생성하는 모든 스크립트가 실행 가능하도록 설정하는 것을 잊지 마세요:

chmod a+rx /jffs/scripts/*

그리고 모든 UNIX 스크립트와 마찬가지로 쉬뱅으로 시작해야 합니다:

#!/bin/sh

또한 파일을 UNIX 줄 끝으로 저장해야 합니다. 윈도우의 메모장은 UNIX 줄 끝으로 저장할 수 없으므로 대신 Notepad++을 사용하세요. 또한 펌웨어에 포함된 vi 또는 nano를 사용하여 라우터에서 SSH를 통해 직접 편집할 수도 있으며, 이들은 적절한 줄 끝으로 파일을 생성합니다.

스크립트 문제 해결:

처음에는 스크립트에 구문 오류가 없는지 확인하기 위해 수동으로 실행해 보세요. 또한 스크립트가 실행되었는지 쉽게 확인할 수 있도록 상단 근처에 일부 코드를 삽입할 수도 있습니다. 예를 들어:

touch /tmp/000wanstarted

/tmp 디렉토리에서 000wanstarted의 존재 여부를 확인하여 스크립트가 실행되었는지 쉽게 알 수 있습니다.

사용자 스크립트 디버깅에 유용한 명령어는 logger이며, 이는 시스템 로그에 메시지를 기록하고 웹 UI에서 볼 수 있습니다.