Docker IP 대역 변경

2025. 12. 3. 18:04·Trouble Shooting

IP 대역을 변경해야 하는 이유

우리 회사의 서비스는 Docker 기반이며 고객사 서버에 배포하는 방식으로 구축한다.

어느 한 고객사에도 마찬가지로 Docker 기반으로 배포하여 개발을 하던 중 고객사에서 우리가 사용 중인 특정 IP 대역을 다른 IP 대역으로 변경해 달라는 요청이 들어왔다.

 

특정 IP 대역은 서비스를 배포한 Docker에서 사용 중이었기 때문에 Docker의 IP 대역을 변경해야 한다는 뜻이었다. Docker의 IP 대역을 변경해본 적이 없어서... 가능한건가? 라는 생각이 들었지만 여러 블로그 글들을 보며 해결하여 사내에도 공유했다.

 

 

요청사항

  • `172.17.x.x` `172.18.x.x` 대역 모두 고객사 사내망에서 사용 중이므로 변경요청
  • 변경할 IP 대역 : `100.64.x.x`

 

서비스가 설치된 호스트의 라우팅 테이블

라우팅 테이블

  • `172.17.x.x` : docker0
  • `172.18.x.x` : docker_gwbride

 

docker0, docker_gwbridge에서 `172.17.x.x` `172.18.x.x` 대역을 사용 중이므로 모두 라우팅 테이블에서 제외해야 한다.

docker0, docker_gwbridge의 IP

docker0

docker를 설치하면 `docker0`의 IP는 자동으로 `172.17.0.1`로 할당되며, 호스트의 eth0 네트워크 인터페이스와 직접적으로 연결되는 네트워크 인터페이스

 

docker_gwbridge

docker container 간 통신을 위한 docker swarm에 사용되는 네트워크 인터페이스

 

 

 

Docker IP 대역 변경

1. daemon.json 수정

docker 설정파일 수정 (없으면 생성)

/etc/docker/daemon.json

{
	"log-driver": "json-file",
	"log-opts": {
		"max-size": "10m",
		"max-file": "3"
	},
	"bip": "100.64.x.x",
	"default-address-pools": [
		{
			"base": "100.64.x.x",
			"size": 24
		}
	]
}

bip

docker가 사용하는 기본 bridge network 대역

 

default-address-pools.base

docker network가 사용하는 대역 (새로운 Docker network를 생성할 때 이 설정을 기반으로 IP 대역을 할당함)

 

 

docker 재시작

systemctl restart docker

 

 

docker0 인터페이스의 IP 대역이 변경된 것을 확인할 수 있다.

 

 

2. 설정 및 설치파일 수정

컨테이너 배포 설정 관련 파일 내에서 IP 변경(`100.64.x.x`)

  • .properties
  • .conf

 

 

3. docker_gwbridge 삭제 및 swarm 재설치

docker swarm leave --force
docker network rm docker_gwbridge

master, slave 구조라면 각각 위처럼 docker_gwbridge를 삭제한다.

그 후 master, slave 모두 swarm 재설치 및 join

 

 

4. 컨테이너 배포 및 재배포

컨테이너를 신규로 배포하거나 재배포한다.

 

docker0, docker_gwbridge 인터페이스 모두 IP 대역이 변경된 것을 확인할 수 있다.

 

 

 

 

참고

https://waspro.tistory.com/635

https://bluese05.tistory.com/15

https://velog.io/@lijahong/0부터-시작하는-Docker-Swarm-공부-더-자세한-Docker-Swarm-Network

https://velog.io/@loveelf1/Docker-default-network-대역-변경

'Trouble Shooting' 카테고리의 다른 글

Gson으로 파싱할 때 double 자동변환  (0) 2025.12.02
'Trouble Shooting' 카테고리의 다른 글
  • Gson으로 파싱할 때 double 자동변환
말차쟁이
말차쟁이
  • 말차쟁이
    Hello world
    말차쟁이
  • 전체
    오늘
    어제
    • 분류 전체보기 (12)
      • SOSO (0)
      • Java (4)
      • Spring (0)
      • Computer Science (1)
      • Object-oriented programming (2)
      • DataBase (0)
      • Git (0)
      • Algorithm (2)
      • Degisn Pattern (0)
      • Network (0)
      • Trouble Shooting (2)
      • 기타 (0)
  • 블로그 메뉴

    • 홈
    • 태그
    • 방명록
  • 링크

  • 공지사항

  • 인기 글

  • 태그

    백준
    알고리즘
    자바
  • 최근 댓글

  • 최근 글

  • hELLO· Designed By정상우.v4.10.3
말차쟁이
Docker IP 대역 변경
상단으로

티스토리툴바