Synology NAS에서 SynoCommunity 패키지로 Gitea를 운영하고 있었는데, 보안 취약점 관련 이슈를 확인하면서 Gitea를 1.26.2-29에서 1.27.1-30으로 업데이트하게 됐다.

내 환경은 다음과 같다.

DSM        : 7.3.2
Gitea 기존 : 1.26.2-29
Gitea 신규 : 1.27.1-30
Architecture: x86_64

Gitea HTTP Port : 8418
Gitea SSH Port  : 202

Reverse Proxy:
Cloudflare → Nginx Proxy Manager → Gitea

SynoCommunity/spksrc #7383 gitea: update from v1.26.2 to v1.27.1

GitHub Actions에서 내 NAS에 맞는:

Build (x64-7.1)

artifact를 다운로드했다.

압축을 풀면 다음 SPK가 나온다.

gitea_x64-7.1_1.27.1-30.spk

sudo synopkg stop gitea

sudo synopkg status gitea

/volume1/@appdata/gitea/conf.ini

[repository]
ROOT = /volume1/git/kwah

[lfs]
PATH = /volume1/git/lfs

[database]
DB_TYPE = postgres
HOST = 192.168.0.4:65432
NAME = gitea
USER = kwah

sudo du -sh /volume1/git

2.3G /volume1/git

sudo mkdir -p /volume1/backup/gitea-20260812

sudo tar -czpf \
  /volume1/backup/gitea-20260812/gitea-appdata.tar.gz \
  /volume1/@appdata/gitea

sudo tar -czpf \
  /volume1/backup/gitea-20260812/gitea-git-data.tar.gz \
  /volume1/git

pg_dump: server version: 15.4
pg_dump version: 11.11

pg_dump: aborting because of server version mismatch

docker ps

postgres:15.4

docker exec postgres \
  pg_dump -U kwah -d gitea -Fc \
  > /volume1/backup/gitea-20260812/gitea-db.dump

docker exec -t postgres ...

cat /volume1/backup/gitea-20260812/gitea-db.dump | \
  docker exec -i postgres pg_restore -l | head -20

Archive created at ...
dbname: gitea
TOC Entries: 1118
Format: CUSTOM

Dumped from database version: 15.4
Dumped by pg_dump version: 15.4

gitea-appdata.tar.gz    약 5.8M
gitea-git-data.tar.gz  약 1.9G
gitea-db.dump           약 1.1M

패키지 센터
→ 수동 설치
→ gitea_x64-7.1_1.27.1-30.spk

sudo synopkg version gitea

1.27.1-30

sudo synopkg start gitea

sudo synopkg status gitea

status: running

ps auxww | grep '[g]itea'

sc-gitea ... /volume1/@appstore/gitea/bin/gitea web \
  --port 8418 \
  --pid /volume1/@appdata/gitea/gitea.pid

sudo head -40 /var/packages/gitea/var/conf.ini

APP_NAME = kwah-git
RUN_USER = sc-gitea
RUN_MODE = prod

[repository]
ROOT = /volume1/git/kwah

[server]
SSH_DOMAIN = git.kwah.dev
DOMAIN = git.kwah.dev
ROOT_URL = https://git.kwah.dev/
HTTP_PORT = 8418
SSH_PORT = 202

[database]
DB_TYPE = postgres
HOST = 192.168.0.4:65432
NAME = gitea
USER = kwah

[security]
INSTALL_LOCK = true

sudo -u sc-gitea \
  /volume1/@appstore/gitea/bin/gitea help

WorkPath:
  /volume1/@appstore/gitea/bin

CustomPath:
  /volume1/@appstore/gitea/bin/custom

ConfigFile:
  /volume1/@appstore/gitea/bin/custom/conf/app.ini

/volume1/@appstore/gitea/bin/custom/conf/app.ini

sudo cat \
  /volume1/@appstore/gitea/bin/custom/conf/app.ini

[server]
LOCAL_ROOT_URL = http://localhost:8418/

/volume1/@appdata/gitea/conf.ini

sudo diff -u \
  /volume1/@appdata/gitea/conf.ini \
  /volume1/@appstore/gitea/bin/custom/conf/app.ini

sudo cp \
  /volume1/@appstore/gitea/bin/custom/conf/app.ini \
  /volume1/@appstore/gitea/bin/custom/conf/app.ini.bak

sudo cp \
  /volume1/@appdata/gitea/conf.ini \
  /volume1/@appstore/gitea/bin/custom/conf/app.ini

ls -l /volume1/@appstore/gitea/bin/custom/conf/app.ini*

-rw------- sc-gitea synocommunity app.ini
-rw------- root     root           app.ini.bak

sudo synopkg start gitea

curl -v http://127.0.0.1:8418/

HTTP/1.1 200 OK
<title>KWAH</title>
Version: 1.27.1

git clone http://git.kwah.dev/lee.git

remote: Enumerating objects: 953, done.
remote: Counting objects: 100% (953/953), done.
remote: Total 953

git add .
git commit -m "push test"

git push

main -> main

기존 Repository 인식
HTTP Clone
Commit
HTTP Push
PostgreSQL 기존 데이터
기존 사용자/Repository

git clone http://git.kwa.dev/lee.git

ROOT_URL = https://git.kwah.dev/

warning: https://git.kwah.dev/... 로 리다이렉트

git clone https://git.kwah.dev/lee.git

git remote set-url origin \
  https://git.kwah.dev/lee.git

The detected web site URL is "http://git.kwah.dev/",
it's unlikely matching the site config.

Mismatched app.ini ROOT_URL or reverse proxy
"Host/X-Forwarded-Proto" config might cause wrong URL links...

ROOT_URL = https://git.kwah.dev/

Browser
  ↓ HTTPS
Cloudflare
  ↓
Nginx Proxy Manager
  ↓ HTTP :8418
Gitea

docker exec npm \
  cat /etc/nginx/conf.d/include/proxy.conf

proxy_set_header Host $host;
proxy_set_header X-Forwarded-Scheme $scheme;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Real-IP $remote_addr;

proxy_pass $forward_scheme://$server:$port$request_uri;

Browser ── HTTPS ──> Cloudflare ── HTTP ──> NPM ── HTTP ──> Gitea

$scheme

http://git.kwah.dev/

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 https;

proxy_set_header X-Forwarded-Proto https;

...

proxy_set_header X-Forwarded-Proto $scheme;

Gitea       : 1.27.1-30
DSM         : 7.3.2
Architecture: x86_64

Gitea       : 정상
PostgreSQL  : 정상
Repository  : 정상
Clone       : 정상
Push        : 정상
NPM         : 정상
Cloudflare  : 정상

/volume1/@appstore/gitea/bin/custom/conf/app.ini

/volume1/@appdata/gitea/conf.ini

/volume1/backup/gitea-20260812/
├── gitea-appdata.tar.gz
├── gitea-db.dump
└── gitea-git-data.tar.gz

1. Gitea 설정/AppData
2. Git Repository + LFS
3. Database dump

gitea help

https://brew.sh 에 접속한다.

Homebrew 설치하기 옆에있는 Copy 아이콘을 클릭하여 선택한다.

터미널을 실행시킨다.

터미널에 해당 커맨드를 붙여넣는다.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

계정 비밀번호를 입력한다.

엔터를 클릭하여 진행한다.

끝난뒤에 해당 커맨드를 입력한다.

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/사용자이름/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

Homebrew가 설치됐는지 해당 커맨드를 통해서 확인한다.

brew --version

<문제상황>

Bootstrap을 통해서 <div>에 container-fluid 클래스를 추가했음에도, 좌우에 여백이 생기는 문제가 발생하였다.
CSS를 찾아보니 아래와 같이 설정되어 있었다.

      --bs-gutter-x: 1.5rem;

해결방법 1: css를 그냥 수정하는 방법

--bs-gutter-x라는 요소가 좌우 간격을 띄우는 역할을 했다.

.container-fluid {
      --bs-gutter-x: 0; /* container-fluid 설정 시에, 좌우에 공백생기는 걸 제거 */
}

해결방법 2: 클래스 추가

--bs-gutter-x가 gutter라는 것을 확인한 뒤에, gutter를 0으로 설정하는 클래스가 있는지 확인했다.
그리고, 해당<div>에만 g-0 클래스를 추가했다.

<div class="container-fluid g-0">
	/* 내용 */
</div>

• 물리 계층(Physical Layer):
  • Ethernet: 네트워크 연결에 사용되는 가장 일반적인 물리 및 데이터 링크 계층 기술 중 하나
  • RS-232: 시리얼 통신에 사용되는 표준
  • V.35, V.90: 모뎀을 통한 데이터 전송 표준
• 데이터 링크 계층(Data Link Layer):
  • Ethernet: 이더넷 프레임을 사용하여 데이터를 전송
  • PPP (Point-to-Point Protocol): 점대점 연결을 통해 데이터를 전송
  • IEEE 802.11: 무선 LAN (Wi-Fi) 표준
• 네트워크 계층(Network Layer):
  • IP (Internet Protocol): 인터넷을 통한 데이터 패킷 전송의 주요 프로토콜
  • ICMP (Internet Control Message Protocol): 네트워크 장치 간의 오류 메시지 및 운영 정보를 전송
  • IGMP (Internet Group Management Protocol): 멀티캐스트 그룹 관리에 사용
• 전송 계층(Transport Layer):
  • TCP (Transmission Control Protocol): 신뢰성 있는 연결 지향적 데이터 전송을 제공
  • UDP (User Datagram Protocol): 연결 없이 데이터를 전송하는 경량 프로토콜
• 세션 계층(Session Layer):
  • NetBIOS (Network Basic Input/Output System): 네트워크 어댑터와 통신할 때 사용되는 서비스 및 프로토콜
  • RPC (Remote Procedure Call): 네트워크를 통해 다른 컴퓨터에 있는 프로그램이 실행될 수 있도록 함
• 표현 계층(Presentation Layer):
  • SSL (Secure Sockets Layer): 데이터 암호화 및 복호화를 관리하여 안전한 데이터 전송을 보장
  • MIME (Multipurpose Internet Mail Extensions): 이메일을 통한 멀티미디어 데이터 전송 표준
• 응용 계층(Application Layer):
  • HTTP (Hypertext Transfer Protocol): 웹 페이지 및 기타 데이터를 전송하는 데 사용됨
  • FTP (File Transfer Protocol): 파일 전송을 위한 프로토콜
  • SMTP (Simple Mail Transfer Protocol): 이메일 전송을 위한 프로토콜

출처) ChatGPT

자바스크립트의 속성 앞에 _(언더스코어)를 쓰는 이유는 이 속성이나 메서드가 비공개임을 나타내는 일반적인 방법이다.

자바스크립트는 자바나 다른 언어들과 달리 직접적으로 접근제어자를 사용할 수 없기 때문에, _(언더스코어)를 사용한다.

ES6 이후에 클래스가 생성됨에 따라서, #을 쓰는 방식으로 바뀌고 있다.

class Example {
    #privateField;

    constructor(value) {
        this.#privateField = value;
    }

    getPrivateField() {
        return this.#privateField; // 내부에서 접근 가능
    }
}

const obj = new Example(123);
console.log(obj.getPrivateField()); // 123 출력
console.log(obj.#privateField); // SyntaxError, 외부에서 접근 불가

출처) ChatGPT

• 모듈이란 특정 데이터들의 집합(파일)을 의미한다.
• 모듈의 import(가져오기) 문법과 export(내보내기) 문법을 사용할 때, 모듈이라고 부를 수 있다.

module.js

export const hello = 'Hello World!'

• module.js에서 다음과 같이 코드를 입력하고, export를 통해서, 내보내기를 한다.

main.js

import { hello } from './module.js'

console.log(hello) // 'Hello World!'

• module.js를 받아오기 위해서는 import를 통해서 받아오기를 진행한다.
• 변수로 선언했던 hello는 {} 사이에 넣어주고, 콘솔을 찍으면, module.js에서와 동일하게 Hello World!가 출력된다.

기본(default) 내보내기

• 모듈에서는 값들을 내보낼 때, default(기본값), 객체, 함수 등을 export(내보내기) 할 수 있다.

module.js

export default defaultValue

• export시에, default를 사용해서, 기본으로 보내는 값을 지정가능하다.

main.js

import value from './moudle.js'

console.log(value); // defaultValue

• import시에, import와 from 사이에, 원하는 변수명을 입력한다.
• 변수로 선언한 값을 conosle에 출력해보면, moudule.js에서 default값으로 선언한 defaultValue라고 나오는 걸 확인할 수 있다.

유명(named) 내보내기

module.js

export const str = "ABC"
const const arr = []
export function hello() {}

• export시에, 함수, 배열, 객체, 변수등을 보내기가 가능하다.

main.js

import { str, arr, hello } from './module.js'

console.log(str); // 'ABC'
console.log(arr); // []
console.log(hello) // function hello()

• import시에, {} 사이에, 변수명을 넣으면, 출력이 가능하다.

main.js

`import { str as alphabet } from './module.js'`

console.log(alphabet); // 'ABC'

• 또한, as를 통해서 변수명을 다르게 변경할 수도 있다.

여러모듈 한번에 내보내기

moduleA.js

export const a = () => abc

moduleB.js

export const b = () => def

main.js

import { a } from './moduleA.js'
import { b } from './moduleB.js'

console.log(a()) //abc
console.log(b()) //def

• 모듈을 합치지 않으면, 다음과 같이 작동하게 된다.
• 하지만 모듈을 합치게 되면 다음과 같은 작용을 하게 된다.

moduleA.js

export const a = () => abc

moduleB.js

export const b = () => def

utils.js

export {a} from './moduleA.js'
export {b} from './moduleB.js'

• moduleA와 moduleB를 바로 export(내보내기)한다.

main.js

import { a, b } from './utils.js'

console.log(a()) // abc
console.log(b()) // def

• 그렇게 되면, 다음과 같이, console.log()에 동일한 결과값을 얻을 수 있다.

Docker Desktop을 실행한다.

상단의 Search에서 nginx를 검색한뒤에 Pull을 클릭한다.

Images 탭에 들어간 뒤에, Run을 클릭한다.

컨테이너 명을 입력하고, Host port에 80을 입력한뒤에 Run을 클릭한다.

브라우저에서 localhost를 검색하면, 적용이 완료된 걸 볼 수 있다.