NPMplus 2025-01-03-alpha Release
요약
참고: 이것은 미리 릴리스이므로 NPMplus를 백업하고 테스트해보시기를 추천합니다. 작동하지 않을 경우 보고해 주세요. (테스트를 한 사람의 수를 확인하기 위해 테스트 후 작동하는지 여러분의 반응을 최소한 주세요)
다음은 최신 릴리스 이전에 아래 사항들이 진행되어야 합니다.
- upstream 병합
- compose.yaml에서 주석 제거
- 새 릴리스 생성 (사람들이 현재 latest로 변경해야 한다는 것을 기억하고 변경된 지오IP 경로도 알려주어야 함)
변경사항
- 모든 호스트는 환경 변수에 영향을 주는 템플릿을 업데이트할 때 단 한 번만 재생성됨
- 유지되는 호스트와 템플릿을 환경 변수에 따라 수정하기 위해 sed 대신 liquidjs 자체 사용
- 많은 마이그레이션이 이제 모든 호스트를 간단히 다시 만들어서 완료됨에 따라 start.sh를 간결하게 함
- 매우 오래된 NPMplus 버전에서의 마이그레이션 제거 (상위 NPM으로부터의 마이그레이션은 가능)
- http/https 포트 변경 허용
- tls-ciphers-no-stapling.conf tls-ciphers.conf를 하나의 파일로 병합
- 기본값으로 ACME_MUST_STAPLE 비활성화
- stapling이 발생해야 하는 경우를 제어하는 새로운 ACME_OCSP_STAPLING 환경 변수, 현재 활성화되어 있으며 4월 말에 비활성화됨
- 환경 변수 DB_SQLITE_FILE은 더 이상 지원되지 않음
- NPM_DISABLE_IPV6 및 GOA_DISABLE_IPV6이 제거되고 DISABLE_IPV6에 포함됨
- http3는 이제 훨씬 빠를 것으로 예상됨 (http3_stream_buffer_size가 너무 작았음)
- 모든 서비스 시작 전에 모든 스테이플링 파일 업데이트
- 기본 호스트는 더 이상 마운트되지 않고 각 컨테이너 시작 시 다시 작성됨
- nginxbeautifier는 이제 호스트 생성 시에만 실행됨
- 응답하지 않는 시작 페이지 수정 (상위 이슈, 상위 커밋 되돌림으로 해결)
- 종속성 업데이트
- php84 지원
- README 업데이트
- security.txt 업데이트
- 폴더 구조 개선
- frontend는 이제 modsec가 활성화되어 있는 경우에만 coreruleset 활성화 허용
- quic_bpf 지원 (기본 미작동, 특권 컨테이너로 NPMplus가 실행되어야 함)
- NIBEP 및 GOAIWSP 기본 값 전환
- streams forwarding_port는 이제 $server_port를 유효한 입력으로 허용
- 도메인 이름 및 stream/proxy forward_host의 허용 구문이 변경됨
- INITIAL_DEFAULT_PAGE 지원 추가
- kyber 삭제 (mlkem은 지원됨)
- upstream 서버에 연결할 때 freenginx 기본 tls 설정 사용
- nginx_custom 폴더를 custom_nginx로 이름 변경
- proxy.conf와 proxy-location.conf를 proxy.conf로 통합
- 새 더미 인증서는 rsa4096 대신 secp384r1 사용
- 일반 구성 파일에 no-servername 파일 통합
- 환경 변수를 통해 hsts 서브도메인 비활성화 허용
- 상위 X_FRAME_OPTIONS env 지원, 기본값을 SAMEORIGIN에서 DENY로 변경, 설정하지 않도록 하는 옵션 추가
- Referrer-Police 헤더 제거 (unset된 경우 기본값은 미설정과 동일하며, 이전 NPMplus와 일치함: strict-origin-when-cross-origin)
- NPMplus API에 인증된/미인증된 요청 시 버전 노출되지 않도록 함
- ACME_KEY_TYPE env 추가 (기본 및 권장 값은 여전히 ecdsa)
- #!/usr/bin/env sh 사용 instead of #!/bin/sh
- dns 비밀은 이제 마운트되지 않음, db에 저장되어 각 컨테이너 시작 시 다시 작성되므로 마운트할 필요 없음
- certbot은 이제 nginx와 함께 빌드됨
테스트 방법
- 위의 변경 사항을 읽으세요
- 컴포즈 yaml에서 태그를 latest/nothing에서 develop로 변경
- 컴포즈 스택 다시 배포
- 발견한 모든 문제 보고
전체 변경 로그: 2024-12-14-r1...2025-01-03-alpha
원문 내용
Note: this is a prerelease, please back up NPMplus and test it if you can, please report back if something does not work (to see how many people test it, please give at least a reaction if you test and it works)
The following still needs to happen before new latest release:
- merge upstream
- compose.yaml remove comments
- create new release (and remember people to switch back to latest now, also remind changing geoip paths)
What's Changed
- all your hosts will now regenerate once and when you update an env which influences a template
- use liquidjs itself instead of sed to modify persistent hosts and templates based on envs
- slim start.sh because many migrations are now done by simply recreating all hosts
- remove migrations from very old NPMplus versions (migration from upstream NPM still possible)
- allow changing http/https ports
- merge tls-ciphers-no-stapling.conf tls-ciphers.conf into one file
- disable ACME_MUST_STAPLE by default
- new ACME_OCSP_STAPLING env controlling if stapling should happen, currently on, will be disabled end april
- env DB_SQLITE_FILE is now unsupported
- NPM_DISABLE_IPV6 and GOA_DISABLE_IPV6 are now removed and included in DISABLE_IPV6
- http3 should now be way faster (http3_stream_buffer_size was too small)
- update all stapling files before starting all services
- default host is not mounted anymore and recreated on each container start
- nginxbeautifier now only runs on hosts generation
- fix unresponsive start page (upstream issue, fixed by reverting upstream commit)
- dep updates
- support php84
- update readme
- update security.txt
- improve folder structure
- frontend now only allows enabling coreruleset if modsec is also enabled
- quic_bpf support (default off, since it needs NPMplus to run as a privileged container)
- NIBEP and GOAIWSP have switched their default values
- streams forwarding_port now allows $server_port as a valid input
- allowed syntax for domain names and stream/proxy forward_host have changed
- added support for INITIAL_DEFAULT_PAGE
- remove kyber (mlkem is supported)
- use freenginx default tls setting when connecting to upstream server
- rename nginx_custom folder to custom_nginx
- unify proxy.conf and proxy-location.conf to proxy.conf
- new dummy certs now use secp384r1 instead of rsa4096
- integrate no-servername files in the normal configs
- allow disabling hsts subdomains via env
- support upstream X_FRAME_OPTIONS env, also change its default from SAMEORIGIN to DENY, add option to not set it
- remove Referrer-Police header (default value when unset is the same as NPMplus used before: strict-origin-when-cross-origin)
- don't expose version when making a (authenticated/unauthenticated) request to NPMplus API
- add ACME_KEY_TYPE env (default and recommended is still ecdsa)
- use #!/usr/bin/env sh instead of #!/bin/sh
- dns secrets are not mounted anymore, since they are saved in the db and rewritten on every container start, so they don't need to be mounted
- certbot is now built together with nginx
How to test
- Read the changes above
- change the tag in your compose yaml from latest/nothing to develop
- redeploy the compose stack
- report any issues you find
Full Changelog: 2024-12-14-r1...2025-01-03-alpha
링크 : https://github.com/ZoeyVid/NPMplus/releases/tag/2025-01-03-alpha