Compare commits

...

6 Commits

Author SHA1 Message Date
xkrrudah 51b573c6c6 Modified sources upload size 2026-08-23 17:36:11 +09:00
xkrrudah b5c1924e79 Modified name 2026-08-19 23:08:40 +09:00
xkrrudah 759779432c Modified nginx file size 2026-08-18 17:42:47 +09:00
xkrrudah 0a178240ce Modified 404 logic 2026-08-18 14:21:26 +09:00
xkrrudah ce2eb8bf4b Modified 404/500 error 2026-08-18 14:14:02 +09:00
xkrrudah dd304c1f31 Modified upstreams.map 2026-08-18 14:06:04 +09:00
7 changed files with 55 additions and 38 deletions
+2 -1
View File
@@ -7,7 +7,7 @@ on:
workflow_dispatch:
env:
DEPLOY_DIR: /volume1/09_container_manager/14_error-page
DEPLOY_DIR: /volume1/09_container_manager/14_gateway
jobs:
deploy-main:
@@ -25,6 +25,7 @@ jobs:
cp docker-compose.yml "$DEPLOY_DIR/docker-compose.yml"
cp nginx.conf "$DEPLOY_DIR/nginx.conf"
cp upstreams.map "$DEPLOY_DIR/upstreams.map"
cp proxy_to_app.conf "$DEPLOY_DIR/proxy_to_app.conf"
cp html/index.html "$DEPLOY_DIR/html/index.html"
rm -f "$DEPLOY_DIR/html/preview.html"
+9 -8
View File
@@ -1,28 +1,28 @@
# error-page
# gateway
`*.takits.me`가 컨테이너 다운으로 502/503/504가 날 때, DSM 기본 에러창 대신 쓰는 공통 nginx.
`*.takits.me`가 컨테이너 다운(502/503/504)이거나 앱이 404/500을 줄 때, DSM 기본 에러창 대신 쓰는 공통 nginx 게이트웨이입니다.
DSM 리버스 프록시가 **앱 포트에 직접** 붙으면, 그 포트가 닫혀 있을 때 나스가 에러 페이지를 그립니다. 이 컨테이너는 항상 `127.0.0.1:4098`에서 떠 있고, `Host`로 실제 앱에 넘긴 뒤 업스트림이 죽었을 때만 공통 페이지를 보여 줍니다.
```
브라우저 → DSM RP (HTTPS) → 127.0.0.1:4098 (error-page)
브라우저 → DSM RP (HTTPS) → 127.0.0.1:4098 (gateway)
└─ Host가 takits.me 이면 127.0.0.1:4889
```
앱의 404/500은 가로채지 않습니다.
페이지 404/500과 게이트웨이 502/503/504는 공통 화면을 씁니다. `/api/` 404만 JSON 그대로 둡니다.
## 배포
`develop`에서 작업한 뒤 `main`에 머지하면 Gitea Actions가 아래 경로로 파일을 동기화하고 컨테이너를 재생성합니다.
```text
/volume1/09_container_manager/14_error-page
/volume1/09_container_manager/14_gateway
```
수동 실행:
```bash
cd /volume1/09_container_manager/14_error-page
cd /volume1/09_container_manager/14_gateway
docker compose up -d
```
@@ -47,7 +47,7 @@ curl -sI -H "Host: unknown.takits.me" http://127.0.0.1:4098/
한 줄 추가 후:
```bash
docker exec error-page nginx -s reload
docker exec gateway nginx -s reload
```
와일드카드 `*.takits.me` → `127.0.0.1:4098` 한 규칙으로 모아도 됩니다. 맵에 없는 호스트는 공통 에러 페이지가 뜹니다.
@@ -57,5 +57,6 @@ docker exec error-page nginx -s reload
| 파일 | 역할 |
|------|------|
| `upstreams.map` | 호스트별 앱 포트 |
| `html/index.html` | 502/503/504 페이지 |
| `html/index.html` | 404/500/502/503/504 페이지 |
| `proxy_to_app.conf` | 앱으로 넘기는 프록시 설정 |
| `nginx.conf` | 프록시 + 에러 가로채기 |
+4 -3
View File
@@ -1,9 +1,9 @@
name: error-page
name: gateway
services:
error-page:
gateway:
image: nginx:alpine
container_name: error-page
container_name: gateway
restart: unless-stopped
# Reach 127.0.0.1-bound app ports on the NAS (DSM reverse proxy style).
network_mode: host
@@ -12,6 +12,7 @@ services:
volumes:
- ./nginx.conf:/etc/nginx/nginx.conf:ro
- ./upstreams.map:/etc/nginx/upstreams.map:ro
- ./proxy_to_app.conf:/etc/nginx/proxy_to_app.conf:ro
- ./html:/usr/share/nginx/html:ro
healthcheck:
test: ["CMD", "wget", "-qO-", "http://127.0.0.1:4098/healthz"]
+1 -4
View File
@@ -105,10 +105,7 @@
<p class="code">__STATUS__</p>
<h1 class="title">__ERROR_TITLE__</h1>
<p class="message">
We're working to resolve the issue.<br />
Please try again shortly.
</p>
<p class="message">__ERROR_MESSAGE__</p>
</main>
<footer>© 2026 takitsme. All rights reserved.</footer>
</body>
+19 -20
View File
@@ -20,11 +20,18 @@ http {
map $status $error_title {
default "Service Unavailable";
404 "Not Found";
500 "Internal Server Error";
502 "Bad Gateway";
503 "Service Unavailable";
504 "Gateway Timeout";
}
map $status $error_message {
default "We're working to resolve the issue.<br />Please try again shortly.";
404 "The page you're looking for could not be found.";
}
include /etc/nginx/upstreams.map;
server {
@@ -33,6 +40,8 @@ http {
root /usr/share/nginx/html;
absolute_redirect off;
client_max_body_size 5g;
proxy_request_buffering off;
location = /healthz {
access_log off;
@@ -40,39 +49,29 @@ http {
return 200 "ok\n";
}
error_page 502 503 504 /__error/index.html;
error_page 404 500 502 503 504 /__error/index.html;
location = /__error/index.html {
internal;
alias /usr/share/nginx/html/index.html;
sub_filter_once off;
sub_filter_types text/html;
sub_filter "__STATUS__" $status;
sub_filter "__ERROR_TITLE__" $error_title;
sub_filter "__ERROR_MESSAGE__" $error_message;
sub_filter "__HOST__" $host;
add_header Cache-Control "no-store" always;
add_header X-Content-Type-Options "nosniff" always;
}
# API 404 stays with the app so JSON clients keep working.
location /api/ {
error_page 500 502 503 504 /__error/index.html;
include /etc/nginx/proxy_to_app.conf;
}
location / {
if ($app_port = 0) {
return 502;
}
proxy_pass http://127.0.0.1:$app_port;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
proxy_connect_timeout 3s;
proxy_send_timeout 3600s;
proxy_read_timeout 3600s;
# Only replace DSM-style "upstream down" pages. App 404/500 stay as-is.
proxy_intercept_errors on;
include /etc/nginx/proxy_to_app.conf;
}
}
}
+18
View File
@@ -0,0 +1,18 @@
if ($app_port = 0) {
return 502;
}
proxy_pass http://127.0.0.1:$app_port;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
proxy_connect_timeout 3s;
proxy_send_timeout 3600s;
proxy_read_timeout 3600s;
proxy_intercept_errors on;
+2 -2
View File
@@ -1,7 +1,7 @@
# Host → published port on the NAS (the destination already used in DSM reverse proxy).
# 0 = unknown host → custom error page.
#
# After adding a line, reload: docker exec error-page nginx -s reload
# After adding a line, reload: docker exec gateway nginx -s reload
# Then point that host's DSM reverse proxy to 127.0.0.1:4098 (not the app port).
map $host $app_port {
@@ -11,9 +11,9 @@ map $host $app_port {
www.takits.me 4889;
fas.takits.me 4885;
dev-fas.takits.me 4886;
android-fas.takits.me 6080;
recap.takits.me 4890;
# ops.fas.takits.me 4887;
# dev-fas.takits.me 4886;
}