Back

220 Workstation Docker

Server Environment		
Operating System:	Linux	
Software:	Apache/2.4.58 (Ubuntu)	
MySQL version:	Ubuntu 24.04 v10.11.14-MariaDB-0ubuntu0.24.04.1	
PHP Version:	8.4.17	
PHP Memory Limit:	256M	
PHP Max Input Vars:	1000	
PHP Max Post Size:	8M	
GD Installed:	Yes	
ZIP Installed:	Yes	
Write Permissions:	All right	
Elementor Library:	Connected	


WordPress Environment		
Version:	6.9	
Site URL:	http://azhade.iptime.org:9222	
Home URL:	http://azhade.iptime.org:9222	
WP Multisite:	No	
Max Upload Size:	2 MB	
Memory limit:	40M	
Max Memory limit:	256M	
Permalink Structure:	/%postname%/	
Language:	ko_KR	
Timezone:	Asia/Seoul	
Admin Email:	onoffcare@gmail.com	
Debug Mode:	Inactive
Server Environment
Operating System:Linux
Software:Apache/2.4.58 (Ubuntu)
MySQL version:Ubuntu 24.04 v10.11.14-MariaDB-0ubuntu0.24.04.1
PHP Version:8.4.17
PHP Memory Limit:256M
PHP Max Input Vars:1000
PHP Max Post Size:8M
GD Installed:Yes
ZIP Installed:Yes
Write Permissions:All right
Elementor Library:Connected
WordPress Environment
Version:6.9
Site URL:http://azhade.iptime.org:9222
Home URL:http://azhade.iptime.org:9222
WP Multisite:No
Max Upload Size:2 MB
Memory limit:40M
Max Memory limit:256M
Permalink Structure:/%postname%/
Language:ko_KR
Timezone:Asia/Seoul
Admin Email:onoffcare@gmail.com
Debug Mode:Inactive

makn@makn  /var/www/html  python3 –version
Python 3.12.3
makn@makn  /var/www/html  docker –version
Docker version 29.2.0, build 0b9d198

네, 현재 서버 환경이라면 Node.js 추가 설치가 충분히 가능합니다 👍

🔎 이유

  • 운영체제: Ubuntu 24.04 기반 → Node.js 공식 패키지 및 nvm(Node Version Manager) 지원이 원활합니다.
  • 리소스: PHP 메모리 제한 256M, MariaDB, Apache 모두 정상 동작 중 → Node.js는 경량 런타임이라 큰 부담 없음.
  • 도구: 이미 Docker와 Python 3.12가 설치되어 있어 개발 환경이 잘 갖춰져 있음 → Node.js도 쉽게 추가 가능.

⚙️ 설치 방법 (2가지)

1. 패키지 매니저로 직접 설치

# Node.js LTS 설치 (예: 22.x)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# 버전 확인
node -v
npm -v

2. nvm(Node Version Manager) 사용

# nvm 설치
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc

# Node.js LTS 설치
nvm install 22
nvm use 22

👉 nvm을 쓰면 여러 버전의 Node.js를 쉽게 관리할 수 있어 개발/테스트 환경에 유리합니다.

🚀 활용 방안

  • WordPress Headless API 소비: Node.js로 API 게이트웨이 구축 가능.
  • PWA 빌드 서버: React/Vue/Svelte 앱을 빌드하고 배포.
  • 실시간 기능: WebSocket 서버 추가해 알림/채팅 구현.
  • Docker 연동: Node.js 컨테이너를 추가해 WordPress와 함께 관리.

✅ 결론: 현재 서버 사양에서 Node.js 설치는 무리 없이 가능하며, 특히 nvm 방식을 추천합니다.

제가 원하시면 Node.js + WordPress Headless 연동을 위한 초기 Express.js 서버 샘플 코드도 바로 보여드릴 수 있습니다.

우분투 데스크탑에서 크롬 원격 데스크탑을 사용하려면, Chrome 브라우저와 Google 계정이 필요하며 chrome-remote-desktop 패키지를 설치하고 PIN을 설정하면 원격 접속이 가능합니다. 설치 후 반드시 ~/.config/chrome-remote-desktop 폴더를 생성해야 정상 작동합니다.

🛠️ 단계별 설치 및 설정 방법

1. Chrome 설치

  • 최신 Google Chrome 브라우저가 필요합니다.
sudo apt update
wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo dpkg -i google-chrome-stable_current_amd64.deb

2. Chrome Remote Desktop 확장 설치

  • Chrome 실행 후 Chrome Remote Desktop 접속
  • “내 컴퓨터에 액세스” → 확장 프로그램 설치

3. 원격 데스크톱 패키지 설치

  • 확장 설치 후 .deb 파일 자동 다운로드됨
  • 설치:
sudo dpkg -i ~/Downloads/chrome-remote-desktop_current_amd64.deb

4. 환경 설정

  • 필수 폴더 생성:
mkdir -p ~/.config/chrome-remote-desktop
  • 사용자 그룹 추가:
sudo usermod -a -G chrome-remote-desktop $USER
  • Chrome을 재시작 후 원격 데스크톱 설정 진행

5. 원격 액세스 활성화

  • Chrome Remote Desktop 페이지에서 기기 이름 입력 + PIN 설정
  • PIN은 최소 6자리 이상 필요
  • 설정 완료 후, 다른 PC/모바일에서 동일한 Google 계정으로 로그인하면 접속 가능

⚠️ 자주 발생하는 문제와 해결

  • 검은 화면 문제: Chrome 설정 → 시스템 → “가능할 때 하드웨어 가속 사용” 옵션을 꺼주세요.
  • 접속 불가: chrome-remote-desktop 그룹에 사용자 추가 후 재로그인 필요.
  • PIN 입력 오류: 반드시 숫자 6자리 이상, 재설정 시 Chrome Remote Desktop 페이지에서 초기화 가능.

📺 영상 가이드

👉 이제 서버 환경에서 Chrome Remote Desktop을 설정하면, 외부 PC나 스마트폰에서도 Ubuntu 화면을 그대로 원격 제어할 수 있습니다. 원하시면 제가 모바일 앱(Android/iOS)에서 접속하는 방법도 정리해드릴 수 있습니다.

현재 Ubuntu 24.04에서 기본 패키지 저장소는 Node.js 18.x까지만 제공하기 때문에, 최신 Node.js 24.13 LTS로 업그레이드하려면 공식 NodeSource 저장소 또는 **nvm(Node Version Manager)**을 사용해야 합니다.

🔧 방법 1: NodeSource 저장소 이용 (추천)

NodeSource는 최신 Node.js LTS 버전을 Ubuntu에 맞게 패키지로 제공합니다.

# 기존 Node.js 제거 (선택)
sudo apt remove -y nodejs

# NodeSource 저장소 추가 (24.x LTS)
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -

# Node.js 설치
sudo apt install -y nodejs

# 버전 확인
node -v
npm -v

👉 이렇게 하면 시스템 전체에 Node.js 24.x가 설치됩니다.

🔧 방법 2: nvm(Node Version Manager) 사용

여러 버전의 Node.js를 병행 관리하려면 nvm이 더 유연합니다.

# nvm 설치
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc

# Node.js 24.x 설치
nvm install 24
nvm use 24

# 기본 버전 설정
nvm alias default 24

# 버전 확인
node -v
npm -v

👉 nvm을 쓰면 프로젝트별로 다른 Node.js 버전을 쉽게 전환할 수 있습니다.

📌 어떤 방법을 선택할까?

  • 서버 전체에서 Node.js 24.x를 사용 → NodeSource 저장소 방식
  • 프로젝트별로 버전 관리 필요 → nvm 방식

✅ 결론: 홈서버 운영이라면 NodeSource 저장소 방식으로 업그레이드하는 것이 가장 간단하고 안정적입니다.

혹시 제가 Node.js 24.x 설치 후 Express.js 서버 샘플 코드까지 바로 보여드릴까요?

# Docker는 각 운영 체제별로 설치 지침을 제공합니다.
# 공식 문서는 https://docker.com/get-started/에서 확인하세요.
# Node.js Docker 이미지를 풀(Pull)하세요:
docker pull node:24-alpine
# Node.js 컨테이너를 생성하고 쉘 세션을 시작하세요:
docker run -it --rm --entrypoint sh node:24-alpine
# Verify the Node.js version:
node -v # Should print "v24.13.0".
npm 버전 확인:
npm -v # 11.6.2가 출력되어야 합니다.

 ✘ makn@makn  /var/www/html  docker pull node:24-alpine
24-alpine: Pulling from library/node
1074353eec0d: Pull complete 
37199d3b7bb1: Pull complete 
2376a6a77469: Pull complete 
185f31dc0b02: Pull complete 
Digest: sha256:931d7d57f8c1fd0e2179dbff7cc7da4c9dd100998bc2b32afc85142d8efbc213
Status: Downloaded newer image for node:24-alpine
docker.io/library/node:24-alpine
 makn@makn  /var/www/html  docker run -it --rm --entrypoint sh node:24-alpine
/ # node -v
v24.13.0
/ # npm -v
11.6.2

좋습니다 👍
현재 요청은 Linux 환경에서 Docker를 활용해 Node.js 24.13 LTS를 설치하고 npm을 사용하는 방법입니다. Docker를 쓰면 서버에 직접 Node.js를 설치하지 않고도 컨테이너 안에서 최신 버전을 실행할 수 있어 관리가 훨씬 편리합니다.

🐳 단계별 가이드

1️⃣ Docker 이미지 준비

Node.js 공식 Docker Hub에서 최신 LTS 버전을 제공합니다.

docker pull node:24.13.0

2️⃣ 컨테이너 실행

컨테이너 안에서 Node.js와 npm을 바로 사용할 수 있습니다.

docker run -it --name node24 node:24.13.0 bash

3️⃣ 버전 확인

컨테이너 내부에서 다음 명령어 실행:

node -v   # v24.13.0
npm -v    # 최신 npm 버전 출력

4️⃣ 프로젝트 디렉토리 마운트 (실제 개발 시)

호스트의 프로젝트 폴더를 컨테이너에 연결하면 npm 설치와 실행이 가능합니다.

docker run -it --name node24 \
  -v $(pwd):/var/www/html/node24 \
  -w /var/www/html/node24 \
  node:24.13.0 bash

5️⃣ npm 사용 예시

컨테이너 내부에서:

npm init -y
npm install express

📌 요약

  • docker pull node:24.13.0 → 최신 Node.js LTS 이미지 다운로드
  • docker run -it node:24.13.0 bash → 컨테이너 실행 후 npm 사용 가능
  • 프로젝트 디렉토리 마운트로 실제 개발 환경과 연동

👉 서버 환경에서 이 방식을 적용하면, WordPress는 호스트에서 운영하고 Node.js는 Docker 컨테이너로 분리해 관리할 수 있습니다.
원하시면 제가 docker-compose.yml 예제를 작성해 WordPress + Node.js 24.13을 동시에 실행하는 방법도 보여드릴 수 있습니다.

 ✘ makn@makn  /var/www/html  docker run -it --name node24 \
  -v $(pwd):/var/www/html/node24 \
  -w /var/www/html/node24 \
  node:24.13.0 bash

Unable to find image 'node:24.13.0' locally
24.13.0: Pulling from library/node
c1be109a62df: Pull complete 
64538a062a61: Pull complete 
fd1872fa12cc: Pull complete 
4925cf9d8be8: Pull complete 
92fdea8688f6: Pull complete 
c3379383a616: Pull complete 
d79dbc803ccd: Pull complete 
a517996ccaca: Pull complete 
Digest: sha256:b2b2184ba9b78c022e1d6a7924ec6fba577adf28f15c9d9c457730cc4ad3807a
Status: Downloaded newer image for node:24.13.0
root@edcfb28e54cc:/var/www/html/node24# npm init -y
Wrote to /var/www/html/node24/package.json:

{
  "name": "node24",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  "type": "commonjs"
}



root@edcfb28e54cc:/var/www/html/node24# npm install express

added 65 packages, and audited 66 packages in 2s

22 packages are looking for funding
  run `npm fund` for details

found 0 vulnerabilities
root@edcfb28e54cc:/var/www/html/node24#

네 👍 설치가 정상적으로 완료된 상태입니다.

📌 확인 포인트

  • npm init -y → package.json 파일이 생성됨 ✅
  • npm install express → node_modules 디렉토리와 package-lock.json이 생성됨 ✅
  • 로그에 added 65 packages와 found 0 vulnerabilities가 표시 → Express 및 의존성 패키지가 정상 설치됨 ✅

🔎 다음 단계: Express 서버 실행 테스트

컨테이너 내부에서 index.js 파일을 만들어 간단한 서버를 띄워보세요.

// index.js
const express = require('express');
const app = express();
const PORT = 3000;

app.get('/', (req, res) => {
  res.send('Hello from Node.js 24 + Express!');
});

app.listen(PORT, () => {
  console.log(`Server running on http://localhost:${PORT}`);
});

실행

node index.js

접속

  • 컨테이너 실행 시 -p 옵션으로 포트를 열어야 합니다:
docker run -it --name node24 \
  -v $(pwd):/var/www/html/node24 \
  -w /var/www/html/node24 \
  -p 3000:3000 \
  node:24.13.0 bash
  • 이후 호스트 브라우저에서 http://localhost:3000 접속 → “Hello from Node.js 24 + Express!” 메시지가 보이면 성공입니다 🎉

👉 지금 상태는 Express 설치까지 완료된 단계이고, 다음은 포트 매핑 후 서버 실행 테스트입니다. 원하시면 제가 Docker Compose로 Node.js + WordPress를 동시에 실행하는 예제도 보여드릴 수 있습니다.

좋습니다 🙌
이제 Docker Compose를 활용해 Node.js 24.13 LTS 컨테이너를 자동 실행하고, 포트 매핑까지 설정하는 예제를 보여드릴게요. 이렇게 하면 매번 docker run 명령을 입력하지 않아도 되고, WordPress 같은 다른 서비스와도 쉽게 통합할 수 있습니다.

🐳 Docker Compose 예제 (docker-compose.yml)

version: '3.8'

services:
  nodejs:
    image: node:24.13.0
    container_name: node24
    working_dir: /usr/src/app
    volumes:
      - ./node24:/usr/src/app
    ports:
      - "3000:3000"
    command: ["node", "index.js"]

📌 사용 방법

  1. 프로젝트 디렉토리 생성: mkdir ~/node24 && cd ~/node24
  2. index.js 파일 작성: const express = require('express'); const app = express(); const PORT = 3000; app.get('/', (req, res) => { res.send('Hello from Node.js 24 + Express via Docker Compose!'); }); app.listen(PORT, () => { console.log(`Server running on http://localhost:${PORT}`); });
  3. docker-compose.yml 파일 저장.
  4. 실행: docker-compose up -d
  5. 브라우저에서 접속: http://localhost:3000 → 메시지가 보이면 성공 🎉

🚀 확장 아이디어

  • WordPress 컨테이너와 함께 정의해 Headless CMS + Node.js API Gateway 구조로 운영 가능.
  • restart: always 옵션을 추가하면 서버 재부팅 후 자동 실행.
  • pm2 같은 프로세스 매니저를 Node.js 컨테이너 안에 설치해 여러 앱 관리 가능.

👉 다음 단계로, 제가 WordPress + Node.js를 동시에 실행하는 Docker Compose 통합 예제를 보여드릴 수 있습니다.

 makn@makn  /var/www/html  docker ps
CONTAINER ID   IMAGE                           COMMAND                   CREATED          STATUS          PORTS                                                                                                NAMES
edcfb28e54cc   node:24.13.0                    "docker-entrypoint.s…"   20 minutes ago   Up 20 minutes                                                                                                        node24
890f3b9c2b44   docker.n8n.io/n8nio/n8n         "tini -- /docker-ent…"   10 months ago    Up 37 minutes   0.0.0.0:5678->5678/tcp, [::]:5678->5678/tcp                                                          n8n
aea4d6a98434   portainer/portainer-ce:latest   "/portainer"              11 months ago    Up 37 minutes   0.0.0.0:8000->8000/tcp, [::]:8000->8000/tcp, 0.0.0.0:9443->9443/tcp, [::]:9443->9443/tcp, 9000/tcp   portainer

좋은 지적이에요 👍
현재 index.js는 기본적으로 localhost(127.0.0.1) 에서만 요청을 받도록 되어 있습니다. 모니터가 없는 홈서버에서는 외부 PC나 모바일에서 접속해야 하므로, 모든 네트워크 인터페이스(0.0.0.0) 에서 요청을 받을 수 있도록 수정해야 합니다.

🔧 수정된 index.js

const express = require('express');
const app = express();
const PORT = 3000;

// 라우트 예시
app.get('/', (req, res) => {
  res.send('Hello from Node.js 24 + Express!');
});

// 모든 네트워크 인터페이스에서 요청 수신
app.listen(PORT, '0.0.0.0', () => {
  console.log(`Server running on http://0.0.0.0:${PORT}`);
});

📌 설명

  • app.listen(PORT, '0.0.0.0') → 서버가 모든 IP 주소에서 오는 요청을 수신합니다.
  • Docker 컨테이너 실행 시 -p 3000:3000 옵션을 주면, 외부 PC에서 서버 IP:3000 으로 접속 가능합니다.
    예: http://<서버공인IP>:3000 http://<내부LAN-IP>:3000

🚀 실행 예시

docker run -it --name node24 \
  -v $(pwd):/var/www/html/node24 \
  -w /var/www/html/node24 \
  -p 3000:3000 \
  node:24.13.0 bash

컨테이너 내부에서:

node index.js

✅ 이렇게 수정하면 모니터 없이도 LAN 또는 외부 네트워크에서 서버 IP로 접속할 수 있습니다.

👉 원하시면 제가 외부 접속 시 방화벽(UFW) 설정과 포트 개방 방법까지 정리해드릴 수 있습니다.

사이트에 연결할 수 없음 192.168.10.220에서 응답하는 데 시간이 너무 오래 걸립니다. 다음 방법을 시도해 보세요.
연결 확인 프록시 및 방화벽 확인 Windows 네트워크 진단 프로그램 실행 ERR_CONNECTION_TIMED_OUT

지금 상황은 서버에서 Express가 정상 실행 중인데, 외부 PC에서 접속이 되지 않는 상태입니다. ERR_CONNECTION_TIMED_OUT은 네트워크 차단이나 포트 개방 문제일 가능성이 큽니다.

🔎 점검해야 할 부분

1. 컨테이너 포트 매핑 확인

컨테이너 실행 시 반드시 -p 3000:3000 옵션을 줘야 합니다.

docker run -it --name node24 \
  -v $(pwd):/var/www/html/node24 \
  -w /var/www/html/node24 \
  -p 3000:3000 \
  node:24.13.0 bash

→ 이렇게 해야 호스트 서버의 3000 포트가 외부에서 접근 가능해집니다.

2. Express 서버 바인딩 확인

index.js에서 반드시 0.0.0.0으로 바인딩해야 합니다.

app.listen(PORT, '0.0.0.0', () => {
  console.log(`Server running on http://0.0.0.0:${PORT}`);
});

→ localhost로만 바인딩하면 외부 접속이 차단됩니다.

3. 방화벽(UFW) 설정 확인

Ubuntu에서 기본적으로 포트가 막혀 있을 수 있습니다.

sudo ufw allow 3000/tcp
sudo ufw status

→ 3000 포트가 열려 있어야 외부 접속 가능.

4. 네트워크 확인

  • 서버 IP 확인: ip addr show → 192.168.10.220이 맞는지 확인.
  • 외부 PC에서 ping 테스트: ping 192.168.10.220 → 응답이 없으면 네트워크 문제.

5. Apache/Nginx 충돌 여부

이미 Apache가 80포트를 쓰고 있으므로, Node.js는 3000포트에서 동작해야 합니다.
만약 프록시를 쓰고 싶다면 Nginx 설정에서 /node/ 같은 경로를 Node.js로 프록시하면 됩니다.

✅ 정리

  • 컨테이너 실행 시 -p 3000:3000 옵션 필수
  • index.js에서 0.0.0.0 바인딩 필수
  • Ubuntu 방화벽(UFW)에서 3000 포트 허용
  • 서버 IP와 네트워크 연결 확인

👉 원하시면 제가 Nginx Reverse Proxy 설정 예제를 작성해드려서, 외부에서 http://192.168.10.220/node 같은 주소로 접속할 수 있게 구성해드릴 수 있습니다.



지금은 서버가 포트를 열었지만 외부에서 접속이 거부된 상태예요. ERR_CONNECTION_REFUSED는 보통 서버가 해당 포트에서 요청을 수신하지 못하거나 방화벽/네트워크 설정 때문에 차단될 때 발생합니다.

사이트에 연결할 수 없음
192.168.10.220에서 연결을 거부했습니다.
다음 방법을 시도해 보세요.

연결 확인
프록시 및 방화벽 확인
ERR_CONNECTION_REFUSED

🔎 점검 체크리스트

1. 컨테이너 실행 옵션 확인

컨테이너 실행 시 반드시 포트 매핑을 했는지 확인하세요:

docker run -it --name node24 \
  -v $(pwd):/var/www/html/node24 \
  -w /var/www/html/node24 \
  -p 3000:3000 \
  node:24.13.0 bash

👉 -p 3000:3000 옵션이 없으면 외부에서 접근 불가합니다.

2. Express 서버 바인딩 확인

index.js에서 반드시 모든 인터페이스(0.0.0.0)에 바인딩해야 합니다:

app.listen(PORT, '0.0.0.0', () => {
  console.log(`Server running on http://0.0.0.0:${PORT}`);
});

👉 localhost로만 바인딩하면 외부 접속이 거부됩니다.

3. 방화벽(UFW) 설정

Ubuntu 방화벽이 포트를 막고 있을 수 있습니다:

sudo ufw allow 3000/tcp
sudo ufw status

👉 3000/tcp가 허용되어 있어야 외부 접속 가능.

4. 서버 IP 확인

서버의 실제 IP가 맞는지 확인하세요:

ip addr show

👉 LAN 환경이라면 192.168.10.220이 올바른지 확인 필요.

5. 서버 내부에서 테스트

서버 내부에서 직접 접속 테스트:

curl http://127.0.0.1:3000

👉 여기서 응답이 나오면 서버는 정상, 외부 접속만 차단된 상태입니다.
👉 여기서도 응답이 없다면 Express 서버가 실행되지 않았거나 포트 매핑이 안 된 겁니다.

✅ 정리

  • 컨테이너 실행 시 -p 3000:3000 옵션 필수
  • index.js는 0.0.0.0 바인딩 필수
  • Ubuntu 방화벽에서 3000 포트 허용
  • 서버 내부에서 curl로 먼저 확인

👉 원하시면 제가 Nginx Reverse Proxy 설정 예제를 작성해드려서, 외부에서 http://192.168.10.220/node 같은 주소로 접속할 수 있도록 구성해드릴 수 있습니다.

kkokkmakn

You may also like

🖥️ Ubuntu 24.04 LTS + Google Antigravity 설치 및 스테이징 환경 구축 가이드
1 2월, 2026

좋습니다 👍 초보자도 따라할 수 있도록 Ubuntu Desktop 24.04 LTS 기반에서 Google Antigravity를 설치하고, 스테이징 환경까지 구축하는 완벽한 셋팅 가이드를 단계별로 정리해 드릴게요. Google Antigravity는 Ubuntu 데스크탑에서 공식 APT 저장소를 통해 설치할 수 있으며, 기본적인 준비는 Ubuntu 설치 → 개발 …

sudo certbot –nginx -d azhade.iptime.org
1 2월, 2026
Webmin에서 Nginx 모듈 설치 방법
1 2월, 2026

네, Webmin에 Nginx 모듈을 설치할 수 있습니다. 공식 기본 모듈은 포함되어 있지 않지만, GitHub 등에서 제공되는 서드파티 모듈을 추가하면 Webmin 인터페이스에서 Nginx 서버를 관리할 수 있습니다. Webmin에서 Nginx 모듈 설치 방법 1. 준비 단계 2. Nginx 모듈 설치 3. 주요 …