Документация и postinst UX: безопасная проверка checksum и preflight-first
This commit is contained in:
@@ -159,7 +159,7 @@ Security note:
|
|||||||
cd awg2_harness
|
cd awg2_harness
|
||||||
./tools/build.sh --prepare-build-env --bootstrap-rust --yes
|
./tools/build.sh --prepare-build-env --bootstrap-rust --yes
|
||||||
./tools/build.sh --package --version 0.1.6
|
./tools/build.sh --package --version 0.1.6
|
||||||
sha256sum -c dist/SHA256SUMS
|
(cd dist && sha256sum -c SHA256SUMS)
|
||||||
dpkg-deb -I dist/awg2-harness_0.1.6_amd64.deb
|
dpkg-deb -I dist/awg2-harness_0.1.6_amd64.deb
|
||||||
dpkg-deb -c dist/awg2-harness_0.1.6_amd64.deb | sort
|
dpkg-deb -c dist/awg2-harness_0.1.6_amd64.deb | sort
|
||||||
```
|
```
|
||||||
|
|||||||
+22
-1
@@ -40,7 +40,7 @@ cargo test --locked --workspace --release --manifest-path Cargo.toml
|
|||||||
|
|
||||||
```bash
|
```bash
|
||||||
./tools/build.sh --package --version 0.1.6
|
./tools/build.sh --package --version 0.1.6
|
||||||
sha256sum -c dist/SHA256SUMS
|
(cd dist && sha256sum -c SHA256SUMS)
|
||||||
dpkg-deb -I dist/awg2-harness_0.1.6_amd64.deb
|
dpkg-deb -I dist/awg2-harness_0.1.6_amd64.deb
|
||||||
dpkg-deb -c dist/awg2-harness_0.1.6_amd64.deb | sort
|
dpkg-deb -c dist/awg2-harness_0.1.6_amd64.deb | sort
|
||||||
```
|
```
|
||||||
@@ -176,6 +176,27 @@ ports={"53/tcp":null,"53/udp":null}
|
|||||||
|
|
||||||
Это означает, что DNS не опубликован на публичном host-интерфейсе и остаётся доступным только через VPN/Docker path.
|
Это означает, что DNS не опубликован на публичном host-интерфейсе и остаётся доступным только через VPN/Docker path.
|
||||||
|
|
||||||
|
Negative-check публичного DNS:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
nslookup example.com <server-public-ip>
|
||||||
|
```
|
||||||
|
|
||||||
|
Ожидаемое поведение: публичный DNS-запрос **не должен успешно резолвиться**. Типичные безопасные варианты ответа: `connection refused`, `timeout` или `no servers could be reached`.
|
||||||
|
|
||||||
|
Optional deep-check DNS path (если нужна углублённая проверка):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
apt install -y dnsutils
|
||||||
|
|
||||||
|
DNS_PID="$(docker inspect -f '{{.State.Pid}}' amnezia-dns)"
|
||||||
|
AWG_PID="$(docker inspect -f '{{.State.Pid}}' amnezia-awg2)"
|
||||||
|
|
||||||
|
nsenter -t "$DNS_PID" -n ss -lntup
|
||||||
|
nsenter -t "$AWG_PID" -n ip route
|
||||||
|
nsenter -t "$AWG_PID" -n dig @172.29.172.254 example.com A +short
|
||||||
|
```
|
||||||
|
|
||||||
## C. Transfer artifacts
|
## C. Transfer artifacts
|
||||||
|
|
||||||
Ниже два production-сценария установки.
|
Ниже два production-сценария установки.
|
||||||
|
|||||||
+2
-2
@@ -25,7 +25,7 @@ cd awg2_harness
|
|||||||
chmod +x tools/build.sh
|
chmod +x tools/build.sh
|
||||||
./tools/build.sh --prepare-build-env --bootstrap-rust --yes
|
./tools/build.sh --prepare-build-env --bootstrap-rust --yes
|
||||||
./tools/build.sh --package --version 0.1.6
|
./tools/build.sh --package --version 0.1.6
|
||||||
sha256sum -c dist/SHA256SUMS
|
(cd dist && sha256sum -c SHA256SUMS)
|
||||||
dpkg-deb -I dist/awg2-harness_0.1.6_amd64.deb
|
dpkg-deb -I dist/awg2-harness_0.1.6_amd64.deb
|
||||||
dpkg-deb -c dist/awg2-harness_0.1.6_amd64.deb | sort
|
dpkg-deb -c dist/awg2-harness_0.1.6_amd64.deb | sort
|
||||||
```
|
```
|
||||||
@@ -41,7 +41,7 @@ dpkg-deb -c dist/awg2-harness_0.1.6_amd64.deb | sort
|
|||||||
## Проверка пакета перед переносом
|
## Проверка пакета перед переносом
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
sha256sum -c dist/SHA256SUMS
|
(cd dist && sha256sum -c SHA256SUMS)
|
||||||
dpkg-deb -I dist/awg2-harness_<version>_amd64.deb
|
dpkg-deb -I dist/awg2-harness_<version>_amd64.deb
|
||||||
dpkg-deb -c dist/awg2-harness_<version>_amd64.deb | sort
|
dpkg-deb -c dist/awg2-harness_<version>_amd64.deb | sort
|
||||||
```
|
```
|
||||||
|
|||||||
+4
-1
@@ -376,8 +376,11 @@ echo "Create /etc/awg2-harness/config.toml manually before enabling services:"
|
|||||||
echo " install -d -m 0755 /etc/awg2-harness"
|
echo " install -d -m 0755 /etc/awg2-harness"
|
||||||
echo " cp /usr/share/doc/awg2-harness/repo/config.example.toml /etc/awg2-harness/config.toml"
|
echo " cp /usr/share/doc/awg2-harness/repo/config.example.toml /etc/awg2-harness/config.toml"
|
||||||
echo " nano /etc/awg2-harness/config.toml"
|
echo " nano /etc/awg2-harness/config.toml"
|
||||||
echo "Then validate and enable services:"
|
echo "Then run preflight before enabling services:"
|
||||||
echo " awg2-harness --config /etc/awg2-harness/config.toml validate-config"
|
echo " awg2-harness --config /etc/awg2-harness/config.toml validate-config"
|
||||||
|
echo " awg2-harness --config /etc/awg2-harness/config.toml validate-runtime"
|
||||||
|
echo " awg2-harness --config /etc/awg2-harness/config.toml status"
|
||||||
|
echo "Enable services only after SSH, Amnezia port and peer CIDR are verified."
|
||||||
echo " systemctl enable --now awg2-harness.service awg2-reboot-scheduler.service"
|
echo " systemctl enable --now awg2-harness.service awg2-reboot-scheduler.service"
|
||||||
|
|
||||||
exit 0
|
exit 0
|
||||||
|
|||||||
Reference in New Issue
Block a user