RECORD 08
학원 내부는 HTTP, 외부는 HTTPS로 접속해야 했던 문제
2026-08-11 · CodeIgniter 4 · 역방향 프록시 · X-Forwarded-Proto
상황
기록 7에서 외부 HTTPS 로그인 경고를 해결하기 위해 .env의 app.baseURL을 HTTPS로 변경했다. 외부 접속은 정상화되었지만 학원 내부에서는 서버에 직접 HTTP로 접속해야 오류 없이 사용할 수 있었다. 하나의 고정 주소만 사용하면 접속 위치에 따라 로그인 폼, 메뉴 링크 또는 로그인 이동 주소가 잘못된 통신 방식으로 생성되는 문제가 남았다.
원인 분석
CodeIgniter의 site_url()과 로그인 폼은 app.baseURL의 통신 방식을 기준으로 절대 주소를 생성한다.
app.baseURL을 HTTP로 고정하면 외부 HTTPS 페이지 안의 폼 주소가 HTTP로 생성되어 보안 경고가 발생한다.
app.baseURL을 HTTPS로 고정하면 학원 내부 HTTP 접속에서도 메뉴와 로그인 주소가 HTTPS로 생성된다.
외부 접속은 Nginx Proxy Manager가 HTTPS를 처리한 뒤 X-Forwarded-Proto: https 정보를 전달하지만, 내부 직접 접속에는 이 정보가 없다.
핵심 원인
같은 사이트가 서로 다른 접속 경로를 사용하는데도 애플리케이션이 .env에 적힌 하나의 고정 통신 방식만 사용한 것이 원인이었다. 따라서 HTTP 또는 HTTPS 중 하나를 포기하는 방식이 아니라, 현재 요청이 실제로 들어온 경로를 판별해 기준 주소를 정해야 했다.
해결 방법
CodeIgniter의 공통 설정 파일인 app/Config/App.php에서 웹 요청의 정보를 확인해 baseURL을 자동으로 구성하도록 변경했다. 외부 프록시가 X-Forwarded-Proto: https를 전달하거나 서버가 443번 포트의 보안 연결을 확인하면 HTTPS를 사용하고, 그 외의 내부 직접 접속은 HTTP를 사용한다.
// 명령줄 작업은 환경 파일의 기본 주소를 사용합니다.
if (PHP_SAPI !== 'cli' && PHP_SAPI !== 'phpdbg') {
$forwardedProtocol = $_SERVER['HTTP_X_FORWARDED_PROTO'] ?? '';
$httpsValue = $_SERVER['HTTPS'] ?? '';
$isSecure = $forwardedProtocol === 'https'
|| ($httpsValue !== '' && $httpsValue !== 'off')
|| (int) ($_SERVER['SERVER_PORT'] ?? 0) === 443;
$this->baseURL = ($isSecure ? 'https' : 'http')
. '://ssm-legacy.kr/';
}
함께 적용한 보호 조치
- 허용된 호스트 이름만 주소 생성에 사용하여 호스트 헤더 변조를 막았다.
ssm-legacy.kr, 내부 서버 주소와 실제 사용하는 별칭만 허용 목록에 넣었다.- 명령줄에서 실행하는 오전 9시 자동 수집 작업은 웹 요청 판별의 영향을 받지 않도록 분리했다.
- 내부 HTTP가 필요한 환경이므로 전체 HTTPS 강제 옵션은 활성화하지 않았다.
검증 결과
- 학원 내부 로그인 폼:
http://ssm-legacy.kr/index.php/auth/login - 외부 프록시 로그인 폼:
https://ssm-legacy.kr/index.php/auth/login - 학원 내부 로그인 이동 주소는 HTTP로, 외부 프록시 로그인 이동 주소는 HTTPS로 각각 생성되었다.
- 서버 점검표와 점검 작성 화면은 모두 HTTP 200으로 정상 응답했다.
- 오전 9시 개인 자동 수집 예약은 그대로 유지되었으며 기존 점검 자료를 다시 수집하지 않았다.
운영 시 주의할 점
X-Forwarded-Proto는 외부 역방향 프록시가 원래 요청의 통신 방식을 알려 주는 값이다. 프록시 구성이 바뀌면 이 전달 정보가 계속 포함되는지 확인해야 한다. 또한 현재 구성은 학원 내부 HTTP 사용이 전제이므로 전체 HTTPS 강제 이동을 추가하면 내부 접속 오류나 반복 이동이 발생할 수 있다.
최종 결론
.env 값을 접속 장소마다 수동으로 바꾸지 않아도 된다. 학원에서는 HTTP로, 외부에서는 HTTPS로 접속하면 로그인 폼과 메뉴를 포함한 사이트 전체 주소가 현재 접속 경로에 맞춰 자동으로 생성된다.