当前，magento 官方商城使用的程序版本是 magento 2.4.6-p1 。尝试安装一下，记录遇到的问题。

问题一：debian 12系统里，默认安装的mariadb版本是10.11.3，但 magento 要求是10.6。数据库的版本过高，magento安装程序不认。

出错信息：Current version of RDBMS is not supported. Used Version: 10.11.3-MariaDB-1. Supported versions: MySQL-8, MySQL-5.7, MariaDB-(10.2-10.6)

或：

Warning: preg_match(): Compilation failed: range out of order in character class at offset 25 in magento/vendor/magento/framework/DB/Adapter/SqlVersionProvider.php on line 101

尝试：

对于第一个报错，按照网上的例子，修改 magento/app/etc/di.xml 文件内容，如：
<item name="MariaDB-(10.2-10.11)" xsi:type="string">^10\.[2-11]\.</item> 直接修改版本号。

第二个报错，修改 magento/vendor/magento/framework/DB/Adapter/SqlVersionProvider.php 文件内容，如：

        $pattern = sprintf('/(%s)/', implode('|', $this->supportedVersionPatterns));
        $pattern = '/10.11/';
        $sqlVersionOutput = '10.11.3-MariaDB-1';
        preg_match($pattern, $sqlVersionOutput, $match);

问题二：magento 安装程序，连接不上刚刚安装的 opensearch ，提示：Could not validate a connection to the opensearch, no alive nodes found in your cluster

尝试：在 /etc/opensearch/opensearch.yml 文件中，添加一行 plugins.security.disabled: true ，即将opensearch的https和用户访问的安全设置禁用。

问题三：使用 nginx 的反向代理 apache 上的 magento 站点后，https 访问异常，如不断地循环跳转。

magento 的站点网址设置等，和平时的差不多，如下例：

catalog/search/engine - opensearch
catalog/search/opensearch_server_hostname - localhost
catalog/search/opensearch_server_port - 9200
catalog/search/opensearch_index_prefix - magento2
catalog/search/opensearch_server_timeout - 15
catalog/category/root_id - 2
web/seo/use_rewrites - 1
web/unsecure/base_url - http://magento.anqun.org/
web/unsecure/base_static_url -
web/unsecure/base_media_url -
web/secure/base_url - https://magento.anqun.org/
web/secure/base_static_url -
web/secure/base_media_url -
web/secure/enable_hsts - 0
web/secure/enable_upgrade_insecure - 0
web/secure/use_in_frontend - 1
web/secure/use_in_adminhtml - 1
web/secure/offloader_header -
web/default_layouts/default_product_layout - product-full-width
web/default_layouts/default_category_layout - category-full-width
web/default_layouts/default_cms_layout - cms-full-width
web/cookie/cookie_path -
web/cookie/cookie_domain -
web/cookie/cookie_httponly - 1
general/locale/code - zh_Hans_CN
general/locale/timezone - Asia/Shanghai
general/region/display_all - 1
general/region/state_required - AL,AR,AU,BG,BO,BR,BY,CA,CH,CL,CN,CO,CZ,DK,EC,EE,ES,GR,GY,HR,IN,IS,IT,LT,LV,MX,PE,PL,PT,PY,RO,SE,SR,US,UY,VE
currency/options/base - CNY
currency/options/default - CNY
currency/options/allow - CNY
analytics/subscription/enabled - 1
crontab/default/jobs/analytics_subscribe/schedule/cron_expr - 0 * * * *
crontab/default/jobs/analytics_collect_data/schedule/cron_expr - 00 02 * * *

关键应该是设置 https 的环境参数，如通过 .htaccess 添加以下内容：

setenv HTTPS on
SetEnv HTTP_X_FORWARDED_PROTO "https"

如果nginx反代配置中使用了 X-Real-IP 头，那么 apache 中的访问日志，可以使用 LogFormat "%h %l %u %t \"%r\" %>s %O \"%{Referer}i\" \"%{User-Agent}i\" \"%{X-Real-IP}i\"" proxycombined 来记录访客IP。

nginx站点例子：

server {
        listen       443 ssl;  
        server_name  magento.anqun.org; 

        ssl_certificate          fullchain.cer;
        ssl_certificate_key      magento.anqun.org.key;

        proxy_buffer_size   128k;
        proxy_buffers   4 256k;
        proxy_busy_buffers_size   256k;

        location / {
                proxy_set_header   Host             $host;
                proxy_set_header   X-Real-IP        $remote_addr;
                proxy_set_header   X-Forwarded-For  $proxy_add_x_forwarded_for;
                proxy_pass         http://192.168.1.9:8001;
        }
}

参考：

• https://github.com/magento/magento2/issues/31109
• https://magento.stackexchange.com/questions/319725/compatible-maridb-version-for-magento-2-4
• https://opensearch.org/docs/1.1/security-plugin/configuration/disable/
• https://gist.github.com/jonathonbyrdziak/d5cba21d4d0e79fb317c
• https://magento.stackexchange.com/questions/331645/err-too-many-redirects-magento-admin/331650#331650
• https://serverfault.com/questions/301254/forward-requesting-ip-from-nginx-to-apaches-logs
• https://experienceleague.adobe.com/docs/commerce-operations/installation-guide/system-requirements.html?mt=false&lang=en

问题： debian 11默认安装的nginx和php7.4-fpm，在wordpress扫描经sftp上传的图片导到媒体库时，经常提示Ajax错误。nginx错误日志为：upstream timed out (110: Connection timed out) while reading response header from upstream。

尝试：在站点的php配置内容中，适当加大超时时间，如：

fastcgi_read_timeout 600;
fastcgi_send_timeout 600;
fastcgi_connect_timeout 600;

参考：https://stackoverflow.com/questions/59713432/nginx-php-fpm-fastcgi-upstream-timed-out

需求：想让别人看到我在电脑上的操作界面。

步骤：

1. apt install libnginx-mod-rtmp # 在debian 11里安装nginx的rtmp模块

2. 在合适的位置，如nginx.conf文件中，添加以下内容，目的是启用rtmp直播及hls

   rtmp {
   server {
       listen 1935;
       application live {
           live on;
           interleave on;
   
           hls on;
           hls_path /var/www/hls;
           hls_fragment 15s;
       }
   }
   }

3. 添加相关的站点设置内容，如：

   server {
       listen 443 ssl http2;
       listen [::]:443 ssl;
   
       ssl_certificate           /etc/nginx/ssl/fullchain.cer;
       ssl_certificate_key       /etc/nginx/ssl/anqun.org.key;
   
       server_name hls.anqun.org;
       root /var/www/hls;
   }
   
   server {
       listen 80;
       listen [::]:80;
   
       server_name hls.anqun.org;
       return 301 https://$server_name$request_uri;
   }

4. 下载ckplayer，放到站点目录中，添加 index.html 文件，内容如下。其中kf.m3u8是obs直播时推送的串流密钥

   <html>
   <head>
       <link rel="stylesheet" type="text/css" href="ckplayer/css/ckplayer.css">
       <script type="text/javascript" charset="utf-8" src="ckplayer/js/ckplayer.js"></script>
   </head>
   <body>
       <div class="video" ></div>
       <script type="text/javascript">
           //定义一个变量：videoObject，用来做为视频初始化配置
   var videoObject = {
   container: '.video', //容器的ID或className
   live:true,//指定为直播
   plug:'hls.js',//使用hls.js插件播放m3u8
   video:'/kf.m3u8'//视频地址
   }
   new ckplayer(videoObject);
       </script>
   </body>
   </html>

5. obs的“推流”设置：服务器为“rtmp://hls.anqun.org/live”；串流密钥为“kf”（这里是测试，所以密钥设置得很简单）
6. 如果顺利，用vlc播放器可以直接播放rtmp://hls.anqun.org/live/kf 的网络地址；其它端可以通过浏览器访问https://hls.anqun.org 播放
7. 本地测试，浏览器播放约有1分钟的延迟

参考：

• https://obsproject.com/forum/resources/how-to-set-up-your-own-private-rtmp-server-using-nginx.50/
• https://www.nginx.com/blog/video-streaming-for-remote-learning-with-nginx/
• https://www.ckplayer.com/manual/13.html#m53

问题：苹果对 apple-app-site-association 的文件要求是不能添加后缀，如不能添加 .json 。nginx默认的设置，如果没有后缀的，当作 octet-stream，浏览器访问时，会弹出下载对话框，而不是直接显示内容。

尝试：可在nginx的站点配置文件里，添加相应的MIME类型，记得重新测试时先清除浏览器的缓存。

location = /.well-known/apple-app-site-association {
  default_type application/json;
}

参考：

• https://serverfault.com/questions/795467/for-what-is-the-well-known-folder/795474
• https://gist.github.com/thomph/951b333a37ee2adb0d3ac557bd75aba4

需求：当前一台机，运行nginx，放置有web站点，想增加多一台机来做负载，分担web访问压力。

尝试：可在A机里新建负载站点site-load，监听80端口，且将访问负载到A机和B机内网IP的8083端口；将A机原站点site-A的监听端口更改到8083，同时将绑定的域名domain移到site-load站里；B机新站点site-B复制site-A的内容，且监听8083端口。

参考：

• https://serverfault.com/questions/163546/how-to-load-balance-with-only-two-servers-using-nginx
• http://nginx.org/en/docs/http/load_balancing.html