zeronet conservancy

零網路保守性

（請注意，翻譯通常位於此文件後面）

по-русски | 波蘭葡萄牙語 | em português 簡體中文 | 日本語

zeronet-conservancy是 ZeroNet 專案（已被其創建者放棄）的一個分支/延續，致力於維持現有的 p2p 網絡並發展其去中心化和自由的價值觀，同時逐漸轉向設計更好的網絡

叉子狀態

在 onion-v3 切換危機期間，我們需要一個與 onion-v3 相容的分叉，並且不依賴對一兩個人的信任。這個分叉從完成這項使命開始，對 ZeroNet/py3 分支實施最小的更改，以便任何人都可以輕鬆審核。

現在 0net 陷入了比以往任何時候都更深的危機，而這個分叉似乎是最後一個倖存的。開發稀疏且緩慢，但一些工作正在幕後完成。如果您對 0net 完全陌生，沒有人指導您並且不是開發人員，我們建議您等到 v0.8 發布。

為什麼是0網？

• 我們相信開放、自由和未經審查的網路和溝通。
• 無單點故障：只要至少 1 個對等點為其提供服務，站點就會保持在線狀態。
• 無託管費用：網站由訪客提供服務。
• 無法關閉：它無處不在，因為它無處不在。
• 快速且離線工作：即使網路不可用，您也可以造訪該網站。

特徵

• 即時更新的網站
• 一鍵克隆網站
• 使用私鑰/公鑰進行無密碼授權
• 內建SQL伺服器，具備P2P資料同步功能：讓動態站台開發更容易
• 匿名：Tor 網路支援 .onion 隱藏服務（包括 onion-v3 支援）
• TLS 加密連線（透過 Clearnet）
• 自動 uPnP 連接埠開啟（如果選擇）
• 用於多用戶（openproxy）支援的插件
• 適用於任何現代瀏覽器/作業系統
• 離線工作，可以透過替代傳輸同步（或當連接恢復時）

它是如何運作的？

• 啟動zeronet.py後，您將能夠使用http://127.0.0.1:43110/{zeronet_address}存取zeronet網站（例如http://127.0.0.1:43110/1MCoA8rQHhwu4LY2t2aabqcGSRqrL8uf2X/ ）。
• 當您造訪新的 Zeronet 網站時，它會嘗試使用 BitTorrent 網路尋找對等點，以便可以從它們下載網站檔案（html、css、js...）。
• 每個造訪過的網站也由您提供服務。
• 每個網站都包含一個content.json文件，該文件以 sha512 哈希形式保存所有其他文件以及使用網站私鑰產生的簽章。
• 如果網站所有者（擁有網站地址的私鑰）修改了網站，那麼他/她會簽署新的content.json並將其發佈給同行。然後，對等點驗證content.json完整性（使用簽章），下載修改後的檔案並將新內容發佈給其他對等點。

以下連結與原始 ZeroNet 相關：

• 關於 ZeroNet 加密、網站更新、多用戶網站的幻燈片 »
• 常見問題 »
• ZeroNet 開發人員文件 »（已過時）

如何加入

從您的分送儲存庫安裝

• NixOS：zeronet-conservancy 包搜尋（見下文）
• ArchLinux：最新版本，新鮮的 git 版本

從 Nix 套件管理器（Linux 或 MacOS）安裝

• 安裝和設定 nix 套件管理器（如果需要）
• nix-env -iA nixpkgs.zeronet-conservancy

或者如果您使用的是 NixOS，請將zeronet-conservancy加入您的系統配置中

（感謝@fgaz 製作和維護該包）

從來源安裝

系統依賴

通用類別 UNIX（包括 mac os x）

安裝autoconf和其他基本開發工具python3和pip，然後繼續「建置python依賴項」（如果由於缺少依賴項而運行失敗，請報告/make pull request修復依賴項清單）

基於 Apt（debian、ubuntu 等）

• sudo apt update
• sudo apt install git pkg-config libffi-dev python3-pip python3-venv python3-dev build-essential libtool

基於 Red Hat 和 Fedora

• yum install epel-release -y 2>/dev/null
• yum install git python3 python3-wheel

基於 Fedora 的 danified

• sudo dnf install git python3-pip python3-wheel -y

開放SUSE

• sudo zypper install python3-pip python3-setuptools python3-wheel

基於 Arch 和 Manjaro

• sudo pacman -S git python-pip -v --no-confirm

安卓/Termux

• 安裝 Termux（在 Termux 中，您可以透過pkg install <package-names>安裝軟體套件）
• pkg update
• pkg install python automake git binutils libtool
• （在較舊的 Android 版本上，您可能還需要安裝） pkg install openssl-tool libcrypt clang
• （如果您已安裝上述軟體包但仍遇到啟動問題，請回報）
• （可選） pkg install tor
• （可選）透過tor --ControlPort 9051 --CookieAuthentication 1命令執行 tor （然後您可以透過向右滑動來開啟新會話）

建置 python 依賴項、venv 和運行

• 複製此儲存庫（注意：在 Android/Termux 上，您應該將其複製到 Termux 的「home」資料夾中，因為虛擬環境不能存在於storage/中）
• python3 -m venv venv （創建python虛擬環境，最後一個venv只是一個名稱，如果你使用不同的，應該在後面的命令中替換它）
• source venv/bin/activate （啟動環境）
• python3 -m pip install -r requirements.txt （安裝依賴項）
• python3 zeronet.py （運行zeronet-conservancy！ ）
• 透過瀏覽器開啟登陸頁面：http://127.0.0.1:43110/
• 要從新終端再次啟動它，您需要導航到 repo 目錄並：
• source venv/bin/activate
• python3 zeronet.py

（或）在 NixOS 上

• 克隆這個倉庫
• nix-shell '<nixpkgs>' -A zeronet-conservancy用於進入已安裝依賴項的 shell
• ./zeronet.py

（或）建置 Docker 映像

• 建置 0net 映像： docker build -t 0net-conservancy:latest . -f Dockerfile
• 或使用整合的 Tor 建置 0net 映像： docker build -t 0net-conservancy:latest . -f Dockerfile.integrated_tor
• 並且運行它： docker run --rm -it -v </path/to/0n/data/directory>:/app/data -p 43110:43110 -p 26552:26552 0net-conservancy:latest
• /path/to/0n/data/directory - 保存所有資料的目錄，包括您的秘密證書。如果您以生產模式運行它，請勿刪除此資料夾！
• 或者你可以使用 docker-compose 來運行它： docker compose up -d 0net-conservancy up 兩個容器 - 分別是 0net 和 tor 。
• 或： docker compose up -d 0net-tor在一個容器中執行 0net 和 tor。 （請檢查這些說明是否仍然準確）

另一種單行程式碼（by @ssdifnskdjfnsdjk）（全域安裝 python 依賴項）

複製 Github 儲存庫並安裝所需的 Python 模組。首先在指令開頭編輯 zndir 路徑，作為要儲存zeronet-conservancy路徑：

zndir="/home/user/myapps/zeronet" ; if [[ ! -d "$zndir" ]]; then git clone --recursive "https://github.com/zeronet-conservancy/zeronet-conservancy.git" "$zndir" && cd "$zndir"||exit; else cd "$zndir";git pull origin master; fi; cd "$zndir" && pip install -r requirements.txt|grep -v "already satisfied"; echo "Try to run: python3 $(pwd)/zeronet.py"

（此指令也可用於使zeronet-conservancy保持最新）

替代腳本

• 安裝常規依賴項和複製儲存庫（如上所述）後，執行start-venv.sh ，這將為您建立一個虛擬環境並安裝 python 需求
• 即將添加更多便利腳本

（非官方）Windows 作業系統建構

下載並解壓縮 .zip 檔案 Zeronet-conservancy-0.7.10-unofficial-win64.zip

Windows作業系統下建構

（這些說明正在開發中，請幫助我們測試並改進它！）

• 從 https://www.python.org/downloads/ 安裝 python
• 安裝一些適合python 的Windows 編譯器，這對我作為非Windows 用戶來說被證明是最困難的部分（請參閱此處https://wiki.python.org/moin/WindowsCompilers ，稍後我將鏈接更多參考資料）
• [可選擇取得最新的開發版本] 從 https://git-scm.com/downloads 安裝 git
• [可選擇使用 Tor 以獲得更好的連接和匿名化] 從 https://www.torproject.org/download/ 安裝 Tor 瀏覽器
• 開啟 git bash 控制台
• 在命令列中輸入/複製貼上git clone https://github.com/zeronet-conservancy/zeronet-conservancy.git
• 等到 git 下載最新的開發版本並在控制台中繼續
• cd zeronet-conservancy
• python -m venv venv （建立虛擬python環境）
• venvScriptsactivate （這會啟動環境）
• pip install -r requirements.txt （安裝python相依性）（有些使用者報告該指令沒有成功安裝需求，只能手動一一安裝相依性）
• （注意：如果上一步失敗，很可能表示您尚未成功安裝 c/c++ 編譯器）
• [Tor 可選，以獲得更好的連接性和匿名性] 啟動 Tor 瀏覽器
• （注意：Windows 可能會顯示一個窗口，表示出於「安全性原因」阻止了對互聯網的訪問 - 您應該允許訪問）
• python zeronet.py --tor_proxy 127.0.0.1:9150 --tor_controller 127.0.0.1:9151 （啟動zeronet-conservancy！）
• [對於完整的 Tor 匿名啟動此替代] python zeronet.py --tor_proxy 127.0.0.1:9150 --tor_controller 127.0.0.1:9151 --tor always
• 在您最喜歡的瀏覽器中導航至 http://127.0.0.1:43110！

建置.exe

• 遵循與上述相同的步驟，但另外
• pip install pyinstaller
• pyinstaller -p src -p plugins --hidden-import merkletools --hidden-import lib.bencode_open --hidden-import Crypt.Crypt --hidden-import Db.DbQuery --hidden-import lib.subtl --hidden-import lib.subtl.subtl --hidden-import sockshandler --add-data "src;src" --add-data "plugins;plugins" --clean zeronet.py
• dist/zeronet 應該包含有效的 Zeronet.exe！

目前的限制

• 文件事務未壓縮
• 沒有私人網站
• 不支援 DHT
• 不支援 I2P
• 像 Zeroid 這樣的集中元素（我們正在研究這個！）
• 沒有可靠的垃圾郵件防護（這一點也是如此）
• 不能直接從瀏覽器運行（中未來的首要任務之一）
• 沒有數據透明度
• 沒有可重現的構建
• 無磁碟加密
• 沒有可重現的構建（因此沒有超出某些 GNU/Linux 發行版的構建）

如何建立 ZeroNet 網站？

• 點選儀表板上的⋮ > “建立新的空站點”選單項目。
• 您將被重定向到一個全新的網站，只能由您修改！
• 您可以在data/[yoursiteaddress]目錄中尋找和修改您網站的內容
• 修改完成後開啟您的網站，將右上角的「0」按鈕拖曳到左側，然後按下底部的簽名和發布按鈕

後續步驟：ZeroNet 開發人員文檔

幫助這個項目保持活力

成為維護者

我們需要更多的維護者！今天就成為其中一員吧！您不需要知道如何編碼，還有很多其他工作要做。

為您的平台進行構建

我們需要針對主要平台的可複製的獨立構建，以及在各種 FLOSS 存儲庫中的存在。如果您使用的 Linux 發行版之一還沒有軟體包，為什麼不為其製作一個軟體包或（如果您不知道如何）現在詢問維護人員？

修復錯誤並添加功能

我們決定繼續製作一個完美的 p2p 網絡，因此我們需要更多幫助來實現它。

創建您的網站/帶來您的內容

我們知道缺乏文檔，但我們會盡力支持任何想要遷移的人。請隨時詢問。

使用它並傳播訊息

確保告訴人們你為什麼使用 0net，特別是這個 fork！人們需要知道他們的選擇。

為維護者提供經濟支持

該分叉由@caryoscelus 創建和維護。您可以在 https://caryoscelus.github.io/donate/ 上查看向他們捐款的方法（如果您在 github 上閱讀本文以了解更多方法，請檢查側邊欄）。隨著我們團隊的成長，我們也會在友善的眾籌平台上建立團隊帳戶。

如果您想確保您的捐贈被視為對該項目的捐贈，也有一個專用的比特幣地址：1Kjuw3reZvxRVNs27Gen7jPJYCn6LY7Fg6。如果您想保持更加匿名和私密，可以使用門羅幣錢包：4AiYUcqVRH4C2CVr9zbBdkhRnJnHiJoypHEsq4N7mQziGUoosPCpPeg8SPr87nvwypaRzDgMHEbWWDekKtq8hmPeg8SPr87nvwypaRzDgMHEbWWDekKtq8hm99LBmgcMzC9

如果您想以其他方式捐贈，請隨時聯絡維護者或建立問題

我們在抗議中使用 GitHub

該專案目前託管在 GitHub 上。這並不理想； GitHub 是一個專有的商業機密系統，不是免費/自由和開源軟體 (FLOSS)。我們非常擔心使用像 GitHub 這樣的專有系統來開發我們的 FLOSS 專案。我們有一個懸而未決的問題來追蹤長期離開 GitHub 的情況。我們強烈建議您閱讀軟體自由保護協會發起的放棄 GitHub 活動，以了解 GitHub 不是託管 FOSS 專案的好地方的一些原因。

如果您是個人已經停止使用 GitHub 的貢獻者，請隨時從我們的 notabug 映像中查看並在那裡進行開發，或透過首選聯絡管道將 git 補丁直接發送給專案維護人員。

GitHub Copilot 過去或現在對本專案程式碼的任何使用均未經我們許可。我們不同意 GitHub 在 Copilot 中使用該專案的程式碼。