v2.0.0-rc.2

[0xJacky]

Notice

We're excited to announce that we've been hard at work developing the next generation of the Nginx UI (v2). To keep up-to-date with our progress, please visit Nginx UI v2.

Please feel free to send any feedback, suggestions, or bug reports on Github issues.

The RC series marks our final testing phase before the stable release.

We appreciate all community feedback and bug reports that help us ensure a smooth official release.

Change vs v2.0.0-rc.1

New Features

🔄 Implemented new recovery code generation and validation system (@Hintay)
📱 Enhanced TOTP enrollment with frontend-generated QR codes (@Hintay)
🤖 Added LLM models and provider constants for AI settings
🔐 Implemented encrypted login and installation requests

Improvements

🌐 Updated Chinese translations (@Hintay)
💄 Refactored TOTP settings UI with improved styling (@Hintay)
🛠️ Optimized CI workflow for branch synchronization
📱 Added Vue history router configuration template

Bug Fixes

🔌 Fixed WebSocket proxy issues
🛑 Fixed user management panic after installation

Maintenance

🧹 General code cleanup and error definition updates
📝 Improved configuration template layout
🔧 Updated DevContainer configuration for better DX

Breaking Changes:

1. Starting from v2.0.0-beta.37, we introduced a new version of the structure of the settings file(v2). When you upgrade to the latest version, it will automatically perform the migration process. Please make sure that the Nginx UI in your server has permission to modify the config file itself. Please check the documentation for more details: https://nginxui.com/.
2. Starting from v2.0.0-beta.36, you must specify the directories where the logs are stored. Only logs within these directories can be viewed online. Check this documentation for more information: https://nginxui.com/guide/config-nginx.html#logdirwhitelist.
3. The CasdoorSettings.Certificate setting has been deprecated and replaced by CasdoorSettings.CertificatePath, which refers to the path of the certificate file.
4. About PR Bugfix/Correct stream conf #445, if you are using nginx-ui docker container and encounter this issue, you have to remove the trailing .conf manually. Diff: https://github.com/0xJacky/nginx-ui/pull/445/files
5. The nginx_log section in the configuration file has been renamed to nginx.
   NginxConfigDir and NginxPIDPath in the server section have been renamed to ConfigDir and PIDPath respectively, and both have been moved into the nginx section.
6. The ReloadCmd and RestartCmd have been added in the nginx section to configure custom commands for reloading/restarting Nginx.
7. In versions above v2.0.0-beta.23 of Nginx UI Docker containers, /var/logs/nginx/access.log and /var/logs/nginx/error.log are no longer soft links to /dev/stdout and /dev/stderr, but regular files. If you need this functionality, please add access_log /dev/stdout and error_log /dev/stderr in your nginx.conf. For users upgrading from older versions who do not need this feature, check if your nginx.conf contains access_log /var/logs/nginx/access.local.log and error_log /var/logs/nginx/error.local.log. If so, please manually remove them to avoid duplicate log entries. This change allows you to map /var/logs/nginx to a directory on the host machine to achieve persistent storage of log files.

What's new:

What's new

1. We're proud to have registered the nginxui.com domain 🎉.
2. We have launched a new documentation site, please check nginxui.com.
3. Node management functionality has been introduced (Support Cluster Management | 支持集群管理 #70).
4. Duplicate site function now can duplicate config to a remote server.
5. French translations have been added, thanks to the contributions of @skrilax91.
6. Added border-radius to Ace Editor and terminal, we hope you will like this change :).
7. You can now deploy site configuration to a remote server.
8. Spanish translations have been added, thanks to the contributions of @kcholoren.
9. Russian translations have been added, thanks to the contributions of @iAHTOH.
10. The dashboard now includes a system monitor for nodes.
11. Use jsoniter for improving gin performance.
12. Added custom reload/restart command for nginx. Configurable nginx reload / restart command #140
13. Refacted translation module The "Ru" and "En" Language Selectors are Mixed Up #135
14. Added HTTP host config add http host config #157 by @quanbisen
15. Add setting for test nginx config command Add support Angie web server #191
16. Added casdoor sso support, thanks to the contributions of @Jraaay
17. Refactor the project directory structure.
18. Use tailwind css.
19. Use eslint to check the code style of frontend.
20. Use vue-tsc to check the types for frontend.
21. Introducing a new management page for certificates, users can now view the latest renewal logs of certain certificates.
22. Add a manually renew button in the certificate modify page for the managed certificate (auto cert).
23. Add notifications for renewing certificates. Add support to set notifications for renew certs. #192
24. Automatically detect the path of access logs and error logs.
25. Introducing the feature of issuing wildcard certificates on the Manage Certificate page. Add support to issue wildcard certificates #190
26. Add some Nginx Config Templates Add some Nginx Config Templates #233, thanks to the contributions of @sanvu88 .
27. Support different key types for obtaining certificates, including RSA2048, RAS3072, RSA4096, EC256 and EC384 可否新增选择自动申请ecc证书或rsa证书的选项 #264.
28. Introducing logroate cron task for docker users Add logrotate to docker container #255.
29. A system default acme user will be registered when nginx ui starts. letsencrypt - too many registrations for this IP #237
30. Add Acme user management page. ACME client implementation flaws #319
31. Persist the Acme user to the database.
32. Add a setting of renewal interval of certificates (7-21d). Add a setting for renewal interval #343
33. Add an option to select an Acme user when obtaining a certificate. ACME client implementation flaws #319 Is it possible to auto-request certificates from not-only Let's Encrypt service? #16
34. SSL management supports different types of certificates of the same domain name. 同一个域名无法共存RSA+ECC双证书 #309, 能否支持自动续签双SSL证书？ #288
35. Certificates obtained within 21 days are renewed by using the renewal API. For compatibility, the challenge resolver is still set up when renewing. ACME client implementation flaws #319
36. Add trash for soft deleted items in CURD pages.
37. Use s6-overlay to manage the services in docker Docker 容器内的多进程建议使用 s6-overlay 管理 #308 .
38. Users can use settings or environment variables to skip installation 修改配置报错runtime error: invalid memory address or nil pointer dereference #357 .
39. Users can use environment variables to predefine an admin user (only available in skip installation mode) Add Env to predefine admin user #214 .
40. Users can customize the name of local environment Nginx UI 的默认环境：本地，这个名称能否自己编辑？ #313 .
41. Users can use the settings file to predefine nodes [Feature] 通过配置文件设置运行节点(Environment) #169 .
42. Hot reload cluster node settings from settings file [Feature] 通过配置文件设置运行节点(Environment) #169.
43. Introducing synchronize certificates to remote server 关于证书管理的一点诉求 #293, 主节点上的证书能否支持同步到多个实例上复用? #363, Syncing certificates between nodes in a cluster #411.
44. Enabled search box for Ace code editor Browser Search not working properly #412.
45. Add a white list of IPs, only those in the list can access the Nginx UI.
46. Add login failed ban IP list.
47. Add 2FA authorization for login 双重验证 2FAS #344, Requires 2FA or other auth validation methods #419.
48. Add 2FA authorization for Web Terminal 终端鉴权优化 #394 .
49. Hide some parts of Jwt Secret and Node Secret on the settings page.
50. The selector of the changed certificate now supports selecting multiple certificates 选择证书建议支持多选 #437 .
51. Certificate(s) Info now supports display info of multiple certificates.
52. The info on changed certificates in the server tab will be shown. 修改Server的证书，点击确定后，回显没有变化 #386
53. Better breadcrumbs Better breadcrumbs to be able to navigate back to lists #258.
54. Add OCSP Must Staple options in AutoCert 证书能否支持增加 OCSP Must-Staple 标识？ #292.
55. Add LEGO_DISABLE_CNAME_SUPPORT options in AutoCert ACME error - Could not find solver for: tls-alpn-01 #407.
56. Added the capability to create new configuration files online.
57. Introduced a feature to rename configuration files.
58. Better breadcrumbs for configurations list and editor.
59. Add filename filter for configurations list.
60. Added the capability to create a new folder in the configurations list.
61. Added the capability to rename folders or files in the configurations list.
62. Implemented deployment of configuration files to remote nodes.
63. Update translations of Korean, thanks for @jkh0kr .
64. Added Portuguese translations—special thanks to @mksarifo.
65. Support Webauthn passkey as a login and 2FA method.
66. Added site category. feat: site category #657
67. Added status filter for site list. Add more condition when search for site #633
68. Added selection box for Nginx Config Template.
69. Added scheme and host fields for the reverse proxy template. Nginx 反向代理模板配置 #608
70. Added German language localization support (contributed by @Jannomag)
71. Implemented new command system architecture
72. Added option for builds without embedded front-end files
73. Introduced DevContainer configuration for easier development setup

Fixes:

1. We've upgraded gonginx to address the configuration parsing issue No code formatting for Manage Sites --> Advanced #73.
2. Fixed an issue where it was not possible to update the settings value to an empty string.
3. Resolved a location-saving issue on the domain addition page 网站管理-添加站点-location内容无保存 #116.
4. Site enabling/disabling is now aborted only when the log level is higher than warning.
5. Fixed environment indicator display overlay and data obtaining issues fixed environment indicator display overlay & edit not obtain newest … #152 by @quanbisen
6. Fixed env indicator background in dark mode.
7. Terminal process not killed 使用2.0.0-beta.3出现的两个问题 #181
8. Added gpt-4-1106-preview model in ChatGPT settings.
9. Fixed change language cause unexpected redirect 在 install 页面选择语言之后页面在 login 和 install 之间疯狂跳转 #189
10. Fixed English grammar error in button text on site management page. English translations error: ENABLED / DISABLED #200
11. Fixed logs mnual link error. Nginx logs manual link error #201
12. Revert enable site if you trying to enable an incorrect config of the site. When I enable a incorrect config file Nginx goes wrong without changing the config file status. #199
13. Upgrade ant design vue version from v3 to v4, thanks @funcfang
14. Fixed FooterToolBar content was covered by Monica, a Chrome Extension. Buttons disappear when a sidebar opened #195
15. Delete server confirm modal not destroy When I delete a server, the popconfirm will stay until I click the cancel button #206
16. clientMaxBodySize name is wrong. Template reverse_proxy.conf wrong name of variables.clientMaxBodySize #216
17. Fix errors may occur when enabling TLS. Error when Enable TLS #230
18. Introducing stream management pages. Add support for stream sites (not just http sites) #166
19. Introducing upstream editor. Upstream backend and load balancing #138
20. Introducing upstream health check (supports TCP and Unix Socket).
21. Fix a bug that may cause nginx-ui to take 100% CPU if the log file is not a regular file.
22. Fix a bug of the loading indicator constantly spinning in the table of configurations management page, if the directory has no file.
23. Fixed Windows-specific client closure error in analytics module (contributed by @caisi35)
24. Resolved duplicate user/attempts tracking issue (contributed by @caisi35)
25. Corrected lmdeploy typo (contributed by @irexyc)

Enhances:

1. The recovery function now can print call stack information.
2. Added file info to config editor.
3. Improved zh_TW locale. Improve zh_TW locale #148
4. Enhance the error handler for execShell.
5. Enhance nginx control and status acquisition. Nginx does not reload when adding a site, enabling a site, or disabling a site #222
6. Remove the validated rules for DNS Credentials

Docs:

1. Traditional Chinese documentation has been added, thanks to @Hintay.
2. We've added documentation for the syntax of the configuration template.
3. We have updated the documentation for the Nginx proxy example.
4. Updated deprecated TLS directives Update deprecated TLS directives  #183

Others:

1. Core upgrades will be performed as a dry run in demo mode.
2. Updated zh_CN translations.
3. Changed Token to NodeSecret fixed environment indicator display overlay & edit not obtain newest … #152
4. Updated configurations of DNS challenges provider.

---

This discussion was created from the release v2.0.0-rc.2.